Class Document
Namespace: Aspose.Pdf
Assembly: Aspose.PDF.dll
Classe che rappresenta un documento PDF
public sealed class Document : IDisposable
Ereditarietà
Implementa
Membri ereditati
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Costruttori
Document(Stream)
Inizializza una nuova istanza di Document dal flusso input
.
public Document(Stream input)
Parametri
input
Stream
Flusso con documento pdf.
Document(Stream, string, bool)
Inizializza una nuova istanza di Document dal flusso input
.
public Document(Stream input, string password, bool isManagedStream)
Parametri
input
Stream
Flusso con documento pdf.
password
string
Password utente o proprietario.
isManagedStream
bool
Se impostato su true
, il flusso interno viene chiuso prima dell’uscita; altrimenti, non lo è.
Document(Stream, bool)
Inizializza una nuova istanza di Document dal flusso input
.
public Document(Stream input, bool isManagedStream)
Parametri
input
Stream
Flusso con documento pdf.
isManagedStream
bool
Se impostato su true
, il flusso interno viene chiuso prima dell’uscita; altrimenti, non lo è.
Document(string)
Inizializza semplicemente il Document utilizzando filename
. È lo stesso di Aspose.Pdf.Document.#ctor(System.IO.Stream).
public Document(string filename)
Parametri
filename
string
Il nome del file del documento pdf.
Document(Stream, string)
Inizializza una nuova istanza di Document dal flusso input
.
public Document(Stream input, string password)
Parametri
input
Stream
Oggetto flusso di input, il corrispondente pdf è protetto da password.
password
string
Password utente o proprietario.
Document()
Inizializza un documento vuoto.
public Document()
Document(string, string)
Inizializza una nuova istanza della classe Aspose.Pdf.Document per lavorare con un documento crittografato.
public Document(string filename, string password)
Parametri
filename
string
Nome del file del documento.
password
string
Password utente o proprietario.
Document(string, string, bool)
Inizializza una nuova istanza della classe Aspose.Pdf.Document per lavorare con un documento crittografato.
public Document(string filename, string password, bool isManagedStream)
Parametri
filename
string
Nome del file del documento.
password
string
Password utente o proprietario.
isManagedStream
bool
Se impostato su true
, il flusso interno viene chiuso prima dell’uscita; altrimenti, non lo è.
Document(string, LoadOptions)
Apre un documento esistente da un file fornendo le opzioni di conversione necessarie per ottenere un documento pdf.
public Document(string filename, LoadOptions options)
Parametri
filename
string
File di input da convertire in documento pdf.
options
LoadOptions
Rappresenta le proprietà per convertire filename
in documento pdf.
Document(Stream, LoadOptions)
Apre un documento esistente da un flusso fornendo le opzioni di conversione necessarie per ottenere un documento pdf.
public Document(Stream input, LoadOptions options)
Parametri
input
Stream
Flusso di input da convertire in documento pdf.
options
LoadOptions
Rappresenta le proprietà per convertire input
in documento pdf.
Campi
DefaultNodesNumInSubtrees
public const byte DefaultNodesNumInSubtrees = 10
Valore del campo
Proprietà
Actions
Ottiene le azioni del documento. Questa proprietà è un’istanza della classe DocumentActions che consente di ottenere/impostare azioni BeforClosing, BeforSaving, ecc.
public DocumentActionCollection Actions { get; }
Valore della proprietà
DocumentActionCollection
Esempi
Questo esempio dimostra come ottenere l’azione dopo l’apertura del documento:
Aspose.Pdf.Document document = new Aspose.Pdf.Document("d:\\work\\aspose\\aspose.pdf.kit.net.new\\trunk\\testdata\\Aspose.Pdf\\PdfWithOpenAction.pdf");
Aspose.Pdf.Annotations.DocumentActionCollection actions = document.Actions;
Aspose.Pdf.Annotations.PdfAction afterSavingAction = actions.AfterSaving;
AllowReusePageContent
Consente di unire i contenuti delle pagine per ottimizzare le dimensioni del documento. Se utilizzato, le pagine diverse ma duplicate possono fare riferimento allo stesso oggetto di contenuto. Si prega di notare che questa modalità può causare effetti collaterali come la modifica del contenuto della pagina quando un’altra pagina viene modificata.
public bool AllowReusePageContent { get; set; }
Valore della proprietà
Background
Ottiene o imposta il colore di sfondo del documento.
public Color Background { get; set; }
Valore della proprietà
Color
CenterWindow
Ottiene o imposta il flag che specifica se la posizione della finestra del documento deve essere centrata sullo schermo.
public bool CenterWindow { get; set; }
Valore della proprietà
Esempi
L’esempio dimostra come ottenere il flag CenterWindow:
Document document = new Document("sample.pdf");
bool value = document.CenterWindow;
Collection
Ottiene la collezione del documento.
public Collection Collection { get; set; }
Valore della proprietà
Collection
CryptoAlgorithm
Ottiene le impostazioni di sicurezza se il documento è crittografato. Se il documento non è crittografato, verrà sollevata l’eccezione corrispondente in .net 1.1 o CryptoAlgorithm sarà nullo per altre versioni di .net.
public CryptoAlgorithm? CryptoAlgorithm { get; }
Valore della proprietà
CryptoAlgorithm?
Destinations
Ottiene la collezione di destinazioni. Obsoleto. Si prega di utilizzare NamedDestinations.
public DestinationCollection Destinations { get; }
Valore della proprietà
DestinationCollection
Direction
Ottiene o imposta l’ordine di lettura del testo: L2R (da sinistra a destra) o R2L (da destra a sinistra).
public Direction Direction { get; set; }
Valore della proprietà
Direction
DisableFontLicenseVerifications
Molte operazioni con i font non possono essere eseguite se queste operazioni sono vietate dalla licenza di questo font. Ad esempio, alcuni font non possono essere incorporati nel documento PDF se le regole di licenza disabilitano l’incorporamento per questo font. Questo flag viene utilizzato per disabilitare eventuali restrizioni di licenza per tutti i font nel documento PDF corrente. Fare attenzione quando si utilizza questo flag. Quando è impostato, significa che la persona che imposta questo flag si assume tutta la responsabilità di eventuali violazioni di licenza/legge. Quindi se lo assume a proprio rischio. Si raccomanda vivamente di utilizzare questo flag solo quando si è completamente certi di non violare la legge sul copyright. Per impostazione predefinita è falso.
public bool DisableFontLicenseVerifications { get; set; }
Valore della proprietà
DisplayDocTitle
Ottiene o imposta il flag che specifica se la barra del titolo della finestra del documento deve visualizzare il titolo del documento.
public bool DisplayDocTitle { get; set; }
Valore della proprietà
Esempi
L’esempio dimostra come ottenere il flag DisplayDocTitle:
Document document = new Document("sample.pdf");
bool value = document.DisplayDocTitle;
Duplex
Ottiene o imposta l’opzione di gestione della modalità duplex di stampa da utilizzare quando si stampa il file dalla finestra di stampa.
public PrintDuplex Duplex { get; set; }
Valore della proprietà
PrintDuplex
EmbedStandardFonts
Proprietà che dichiara che il documento deve incorporare tutti i font standard Type1 che hanno il flag IsEmbedded impostato su true. Tutti i font PDF possono essere incorporati nel documento semplicemente impostando il flag IsEmbedded su true, ma i font standard Type1 sono un’eccezione a questa regola. L’incorporamento dei font standard Type1 richiede molto tempo, quindi per incorporare questi font è necessario non solo impostare il flag IsEmbedded su true per il font specificato, ma anche impostare un flag aggiuntivo a livello di documento - EmbedStandardFonts = true; Questa proprietà può essere impostata solo una volta per tutti i font. Per impostazione predefinita è falso.
public bool EmbedStandardFonts { get; set; }
Valore della proprietà
EmbeddedFiles
Ottiene la collezione di file incorporati nel documento.
public EmbeddedFileCollection EmbeddedFiles { get; }
Valore della proprietà
EmbeddedFileCollection
EnableObjectUnload
Ottiene o imposta il flag che consente al documento di essere parzialmente scaricato dalla memoria. Questo consente di ridurre l’uso della memoria, ma può avere un effetto negativo sulle prestazioni.
public bool EnableObjectUnload { get; set; }
Valore della proprietà
EnableSignatureSanitization
Ottiene o imposta il flag per gestire la sanificazione dei campi di firma. Abilitato per impostazione predefinita.
public bool EnableSignatureSanitization { get; set; }
Valore della proprietà
FileName
Nome del file PDF che ha causato questo documento
public string FileName { get; }
Valore della proprietà
FitWindow
Ottiene o imposta il flag che specifica se la finestra del documento deve essere ridimensionata per adattarsi alla prima pagina visualizzata.
public bool FitWindow { get; set; }
Valore della proprietà
Esempi
L’esempio dimostra come ottenere il flag FitWindow:
Document document = new Document("sample.pdf");
bool value = document.FitWindow;
FontUtilities
Istanza di IDocumentFontUtilities
public Document.IDocumentFontUtilities FontUtilities { get; }
Valore della proprietà
Document.IDocumentFontUtilities
Form
Ottiene l’Acro Form del documento.
public Form Form { get; }
Valore della proprietà
Form
HandleSignatureChange
Sollevare un’eccezione se il documento verrà salvato con modifiche e ha una firma
public bool HandleSignatureChange { get; set; }
Valore della proprietà
HideMenubar
Ottiene o imposta il flag che specifica se la barra dei menu deve essere nascosta quando il documento è attivo.
public bool HideMenubar { get; set; }
Valore della proprietà
Esempi
L’esempio dimostra come ottenere il flag HideMenubar:
Document document = new Document("sample.pdf");
bool value = document.HideMenubar;
HideToolBar
Ottiene o imposta il flag che specifica se la barra degli strumenti deve essere nascosta quando il documento è attivo.
public bool HideToolBar { get; set; }
Valore della proprietà
Esempi
L’esempio dimostra come ottenere il flag HideToolBar:
Document document = new Document("sample.pdf");
bool value = document.HideToolBar;
HideWindowUI
Ottiene o imposta il flag che specifica se gli elementi dell’interfaccia utente devono essere nascosti quando il documento è attivo.
public bool HideWindowUI { get; set; }
Valore della proprietà
Esempi
L’esempio dimostra come ottenere il flag HideWindowUI:
Document document = new Document("sample.pdf");
bool value = document.HideWindowUI;
Id
Ottiene l’ID.
public Id Id { get; }
Valore della proprietà
Id
IgnoreCorruptedObjects
Ottiene o imposta il flag per ignorare gli errori nei file sorgente. Quando le pagine del documento sorgente vengono copiate nel documento di destinazione, il processo di copia si interrompe con un’eccezione se alcuni oggetti nei file sorgente sono danneggiati quando questo flag è falso. esempio: dest.Pages.Add(src.Pages); Se questo flag è impostato su true, gli oggetti danneggiati verranno sostituiti con valori vuoti. Per impostazione predefinita: true.
public bool IgnoreCorruptedObjects { get; set; }
Valore della proprietà
Info
Ottiene le informazioni sul documento.
public DocumentInfo Info { get; }
Valore della proprietà
DocumentInfo
IsEncrypted
Ottiene lo stato di crittografia del documento. True se il documento è crittografato.
public bool IsEncrypted { get; }
Valore della proprietà
IsLicensed
Ottiene lo stato di licenza del sistema. Restituisce true se il sistema funziona in modalità licenziata e false altrimenti.
public static bool IsLicensed { get; }
Valore della proprietà
IsLinearized
Ottiene o imposta un valore che indica se il documento è linearizzato.
public bool IsLinearized { get; set; }
Valore della proprietà
IsPdfUaCompliant
Ottiene se il documento è conforme a pdfua.
public bool IsPdfUaCompliant { get; }
Valore della proprietà
IsPdfaCompliant
Ottiene se il documento è conforme a pdfa.
public bool IsPdfaCompliant { get; }
Valore della proprietà
IsXrefGapsAllowed
Ottiene o imposta se il documento è conforme a pdfa.
public bool IsXrefGapsAllowed { get; set; }
Valore della proprietà
JavaScript
Collezione di JavaScript a livello di documento.
public JavaScriptCollection JavaScript { get; }
Valore della proprietà
JavaScriptCollection
LogicalStructure
Ottiene la struttura logica del documento.
public RootElement LogicalStructure { get; }
Valore della proprietà
RootElement
Metadata
Metadati del documento. (Un documento PDF può includere informazioni generali, come il titolo del documento, l’autore e le date di creazione e modifica. Tali informazioni globali sul documento (a differenza del suo contenuto o della sua struttura) sono chiamate metadati e sono destinate ad assistere nella catalogazione e nella ricerca di documenti in database esterni.)
public Metadata Metadata { get; }
Valore della proprietà
Metadata
NamedDestinations
Collezione di Destinazioni Nominate nel documento.
public NamedDestinationCollection NamedDestinations { get; }
Valore della proprietà
NamedDestinationCollection
NonFullScreenPageMode
Ottiene o imposta la modalità pagina, specificando come visualizzare il documento all’uscita dalla modalità a schermo intero.
public PageMode NonFullScreenPageMode { get; set; }
Valore della proprietà
PageMode
OpenAction
Ottiene o imposta l’azione eseguita all’apertura del documento.
public IAppointment OpenAction { get; set; }
Valore della proprietà
IAppointment
Esempi
L’esempio dimostra come ottenere il flag CenterWindow:
Document document = new Document("sample.pdf");
IAppointment value = document.OpenAction;
OptimizeSize
Ottiene o imposta il flag di ottimizzazione. Quando le pagine vengono aggiunte al documento, i flussi di risorse uguali nel file risultante vengono uniti in un oggetto PDF se questo flag è impostato. Questo consente di ridurre le dimensioni del file risultante, ma può causare un’esecuzione più lenta e maggiori requisiti di memoria. Valore predefinito: false.
public bool OptimizeSize { get; set; }
Valore della proprietà
Outlines
Ottiene i contorni del documento.
public OutlineCollection Outlines { get; }
Valore della proprietà
OutlineCollection
OutputIntents
Ottiene la collezione di Intenti di Output nel documento.
public OutputIntents OutputIntents { get; }
Valore della proprietà
OutputIntents
PageInfo
Ottiene o imposta le informazioni sulla pagina. (solo per il generatore, non compilato quando si legge il documento)
public PageInfo PageInfo { get; set; }
Valore della proprietà
PageInfo
PageLabels
Ottiene le etichette delle pagine nel documento.
public PageLabelCollection PageLabels { get; }
Valore della proprietà
PageLabelCollection
PageLayout
Ottiene o imposta il layout della pagina che deve essere utilizzato quando il documento viene aperto.
public PageLayout PageLayout { get; set; }
Valore della proprietà
PageLayout
PageMode
Ottiene o imposta la modalità pagina, specificando come il documento dovrebbe essere visualizzato quando aperto.
public PageMode PageMode { get; set; }
Valore della proprietà
PageMode
Pages
Ottiene o imposta la collezione delle pagine del documento. Si noti che le pagine sono numerate da 1 nella collezione.
public PageCollection Pages { get; }
Valore della proprietà
PageCollection
Esempi
L’esempio seguente dimostra come operare con le pagine del documento: Come ottenere il numero di pagine e come ottenere il rettangolo della pagina iniziale del documento.
Aspose.Pdf.Document document = new Aspose.Pdf.Document("sample.pdf");
Aspose.Pdf.PageCollection pages = document.Pages;
System.Console.WriteLine("Il documento contiene " + pages.Count);
Page page = pages[1];
Rectangle rect = page.Rect;
PdfFormat
Ottiene il formato PDF
public PdfFormat PdfFormat { get; }
Valore della proprietà
PdfFormat
Permissions
Ottiene i permessi del documento.
public int Permissions { get; }
Valore della proprietà
PickTrayByPdfSize
Ottiene o imposta un flag che specifica se la dimensione della pagina PDF deve essere utilizzata per selezionare il vassoio di carta di input.
public bool PickTrayByPdfSize { get; set; }
Valore della proprietà
PrintScaling
Ottiene o imposta l’opzione di scaling della pagina che deve essere selezionata quando viene visualizzata una finestra di stampa per questo documento.
public PrintScaling PrintScaling { get; set; }
Valore della proprietà
PrintScaling
TaggedContent
Ottiene accesso al contenuto TaggedPdf.
public ITaggedContent TaggedContent { get; }
Valore della proprietà
ITaggedContent
Esempi
L'esempio dimostra come utilizzare il contenuto taggato per creare un nuovo documento con intestazione, paragrafi e immagini.
// Crea un nuovo documento
Document document = new Document();
// Ottieni il contenuto taggato
ITaggedContent taggedContent = document.TaggedContent;
// Imposta la lingua per il documento
taggedContent.SetLanguage("en-US");
// Imposta il titolo per il documento PDF
taggedContent.SetTitle("Esempio di documento");
// Creazione e aggiunta di una Sezione
SectElement sect = taggedContent.CreateSectElement();
taggedContent.RootElement.AppendChild(sect);
// Crea l'intestazione
HeaderElement h1 = taggedContent.CreateHeaderElement(1);
h1.SetText("L'Intestazione");
sect.AppendChild(h1);
// Crea un paragrafo
ParagraphElement p = taggedContent.CreateParagraphElement();
p.SetTag("Paragrafo");
p.SetText("Il testo del paragrafo.");
sect.AppendChild(p);
// Crea un'illustrazione
IllustrationElement figure1 = taggedContent.CreateFigureElement();
sect.AppendChild(figure1);
figure1.AlternativeText = "Figura 1";
figure1.Title = "Immagine 1";
figure1.SetTag("Fig");
figure1.SetImage("path/of/image.jpg");
// Salva il documento
document.Save("example.pdf");
Version
Ottiene una versione di Pdf dall’intestazione del file Pdf.
public string Version { get; }
Valore della proprietà
Metodi
BindXml(string)
Collega xml al documento
public void BindXml(string file)
Parametri
file
string
Il file xml
BindXml(string, string)
Collega xml/xsl al documento
public void BindXml(string xmlFile, string xslFile)
Parametri
xmlFile
string
Il file xml.
xslFile
string
Il file xsl se viene utilizzato XSLT.
BindXml(Stream, Stream)
Collega xml/xsl al documento
public void BindXml(Stream xmlStream, Stream xslStream)
Parametri
xmlStream
Stream
Il flusso xml.
xslStream
Stream
Il flusso xsl se viene utilizzato XSLT.
BindXml(Stream, Stream, XmlReaderSettings)
Collega xml/xsl al documento
public void BindXml(Stream xmlStream, Stream xslStream, XmlReaderSettings settings)
Parametri
xmlStream
Stream
Il flusso xml.
xslStream
Stream
Il flusso xsl se viene utilizzato XSLT.
settings
XmlReaderSettings
Le impostazioni del lettore xml.
BindXml(Stream)
Collega xml al documento
public void BindXml(Stream stream)
Parametri
stream
Stream
Il flusso xml.
ChangePasswords(string, string, string)
Cambia le password del documento. Questa azione può essere eseguita solo utilizzando la password del proprietario.
public void ChangePasswords(string ownerPassword, string newUserPassword, string newOwnerPassword)
Parametri
ownerPassword
string
Password del proprietario.
newUserPassword
string
Nuova password utente.
newOwnerPassword
string
Nuova password del proprietario.
Check(bool)
Valida il documento.
public bool Check(bool doRepair)
Parametri
doRepair
bool
Se vero, i problemi trovati verranno riparati.
Restituisce
Vero - se il documento è stato riparato; altrimenti, falso.
Convert(string, PdfFormat, ConvertErrorAction, ConvertTransparencyAction)
Converte il documento e salva gli errori nel file specificato.
public bool Convert(string outputLogFileName, PdfFormat format, ConvertErrorAction action, ConvertTransparencyAction transparencyAction)
Parametri
outputLogFileName
string
Percorso del file in cui verranno memorizzati i commenti.
format
PdfFormat
Il formato pdf.
action
ConvertErrorAction
Azione per gli oggetti che non possono essere convertiti
transparencyAction
ConvertTransparencyAction
Azione per gli oggetti mascherati delle immagini
Restituisce
Risultato dell’operazione
Convert(Stream, PdfFormat, ConvertErrorAction, ConvertTransparencyAction)
Converte il documento e salva gli errori nel file specificato.
public bool Convert(Stream outputLogStream, PdfFormat format, ConvertErrorAction action, ConvertTransparencyAction transparencyAction)
Parametri
outputLogStream
Stream
Flusso in cui verranno memorizzati i commenti.
format
PdfFormat
Il formato pdf.
action
ConvertErrorAction
Azione per gli oggetti che non possono essere convertiti
transparencyAction
ConvertTransparencyAction
Azione per gli oggetti mascherati delle immagini
Restituisce
Risultato dell’operazione
Convert(string, PdfFormat, ConvertErrorAction)
Converte il documento e salva gli errori nel file specificato.
public bool Convert(string outputLogFileName, PdfFormat format, ConvertErrorAction action)
Parametri
outputLogFileName
string
Percorso del file in cui verranno memorizzati i commenti.
format
PdfFormat
Il formato pdf.
action
ConvertErrorAction
Azione per gli oggetti che non possono essere convertiti
Restituisce
Risultato dell’operazione
Convert(PdfFormatConversionOptions)
Converte il documento utilizzando le opzioni di conversione specificate
public bool Convert(PdfFormatConversionOptions options)
Parametri
options
PdfFormatConversionOptions
set di opzioni per convertire il documento PDF
Restituisce
Risultato dell’operazione
Convert(CallBackGetHocrWithPage, bool)
Riconosce le immagini all’interno del documento e aggiunge le stringhe hocr sopra di esse.
public bool Convert(Document.CallBackGetHocrWithPage callback, bool flattenImages = false)
Parametri
callback
Document.CallBackGetHocrWithPage
Azione per le immagini che verranno elaborate dal riconoscimento hocr.
flattenImages
bool
Il testo nelle immagini pdf può essere dipinto utilizzando la meccanica delle maschere, nel qual caso le immagini devono essere appiattite.
Restituisce
Risultato dell’operazione. Se non ci sono immagini nel documento, restituisce falso.
Convert(CallBackGetHocr, bool)
Riconosce le immagini all’interno del documento e aggiunge le stringhe hocr sopra di esse.
public bool Convert(Document.CallBackGetHocr callback, bool flattenImages = false)
Parametri
callback
Document.CallBackGetHocr
Azione per le immagini che verranno elaborate dal riconoscimento hocr.
flattenImages
bool
Il testo nelle immagini pdf può essere dipinto utilizzando la meccanica delle maschere, nel qual caso le immagini devono essere appiattite.
Restituisce
Risultato dell’operazione. Se non ci sono immagini nel documento, restituisce falso.
Convert(Stream, PdfFormat, ConvertErrorAction)
Converte il documento e salva gli errori nel flusso specificato.
public bool Convert(Stream outputLogStream, PdfFormat format, ConvertErrorAction action)
Parametri
outputLogStream
Stream
Flusso in cui verranno memorizzati i commenti.
format
PdfFormat
Formato pdf.
action
ConvertErrorAction
Azione per gli oggetti che non possono essere convertiti
Restituisce
Risultato dell’operazione
Convert(Fixup, Stream, bool, object[])
Converte il documento applicando il Fixup.
public bool Convert(Fixup fixup, Stream outputLog, bool onlyValidation = false, object[] parameters = null)
Parametri
fixup
Fixup
Il tipo di Fixup.
outputLog
Stream
Il log del processo.
onlyValidation
bool
Solo validazione del documento.
parameters
object[]
Proprietà per Fixup che non possono essere impostate.
Restituisce
Risultato dell’operazione.
Convert(Fixup, string, bool, object[])
Converte il documento applicando il Fixup.
public bool Convert(Fixup fixup, string outputLog, bool onlyValidation = false, object[] parameters = null)
Parametri
fixup
Fixup
Il tipo di Fixup.
outputLog
string
Il log del processo.
onlyValidation
bool
Solo validazione del documento.
parameters
object[]
Proprietà per Fixup che non possono essere impostate.
Restituisce
Risultato dell’operazione.
Convert(string, LoadOptions, string, SaveOptions)
Converte il file sorgente nel formato sorgente in un file di destinazione nel formato di destinazione.
public static void Convert(string srcFileName, LoadOptions loadOptions, string dstFileName, SaveOptions saveOptions)
Parametri
srcFileName
string
Il nome del file sorgente.
loadOptions
LoadOptions
Il formato del file sorgente.
dstFileName
string
Il nome del file di destinazione.
saveOptions
SaveOptions
Il formato del file di destinazione.
Convert(Stream, LoadOptions, string, SaveOptions)
Converte il flusso nel formato sorgente in un file di destinazione nel formato di destinazione.
public static void Convert(Stream srcStream, LoadOptions loadOptions, string dstFileName, SaveOptions saveOptions)
Parametri
srcStream
Stream
Il flusso sorgente.
loadOptions
LoadOptions
Il formato del flusso sorgente.
dstFileName
string
Il nome del file di destinazione.
saveOptions
SaveOptions
Il formato del file di destinazione.
Convert(string, LoadOptions, Stream, SaveOptions)
Converte il file sorgente nel formato sorgente in un flusso nel formato di destinazione.
public static void Convert(string srcFileName, LoadOptions loadOptions, Stream dstStream, SaveOptions saveOptions)
Parametri
srcFileName
string
Il nome del file sorgente.
loadOptions
LoadOptions
Il formato del file sorgente.
dstStream
Stream
Il flusso di destinazione.
saveOptions
SaveOptions
Il formato del flusso di destinazione.
Convert(Stream, LoadOptions, Stream, SaveOptions)
Converte il flusso nel formato sorgente in un flusso nel formato di destinazione.
public static void Convert(Stream srcStream, LoadOptions loadOptions, Stream dstStream, SaveOptions saveOptions)
Parametri
srcStream
Stream
Il flusso sorgente.
loadOptions
LoadOptions
Il formato del flusso sorgente.
dstStream
Stream
Il flusso di destinazione.
saveOptions
SaveOptions
Il formato del flusso di destinazione.
ConvertPageToPNGMemoryStream(Page)
Converte la pagina in PNG per DSR, OMR, flusso immagine OCR.
public MemoryStream ConvertPageToPNGMemoryStream(Page page)
Parametri
page
Page
Pagina da convertire.
Restituisce
Flusso immagine.
Decrypt()
Decripta il documento. Chiamare quindi Salva per ottenere la versione decrittografata del documento.
public void Decrypt()
Dispose()
Chiude tutte le risorse utilizzate da questo documento.
public void Dispose()
Encrypt(string, string, DocumentPrivilege, CryptoAlgorithm, bool)
Crittografa il documento. Chiamare quindi Salva per ottenere la versione crittografata del documento.
public void Encrypt(string userPassword, string ownerPassword, DocumentPrivilege privileges, CryptoAlgorithm cryptoAlgorithm, bool usePdf20)
Parametri
userPassword
string
Password utente.
ownerPassword
string
Password del proprietario.
privileges
DocumentPrivilege
Permessi del documento, vedere Aspose.Pdf.Document.Permissions per dettagli.
cryptoAlgorithm
CryptoAlgorithm
Algoritmo crittografico, vedere Aspose.Pdf.Document.CryptoAlgorithm per dettagli.
usePdf20
bool
Supporto per la revisione 6 (Estensione 8).
Encrypt(string, string, Permissions, CryptoAlgorithm)
Crittografa il documento. Chiamare quindi Salva per ottenere la versione crittografata del documento.
public void Encrypt(string userPassword, string ownerPassword, Permissions permissions, CryptoAlgorithm cryptoAlgorithm)
Parametri
userPassword
string
Password utente.
ownerPassword
string
Password del proprietario.
permissions
Permissions
Permessi del documento, vedere Aspose.Pdf.Document.Permissions per dettagli.
cryptoAlgorithm
CryptoAlgorithm
Algoritmo crittografico, vedere Aspose.Pdf.Document.CryptoAlgorithm per dettagli.
Encrypt(string, string, Permissions, CryptoAlgorithm, bool)
Crittografa il documento. Chiamare quindi Salva per ottenere la versione crittografata del documento.
public void Encrypt(string userPassword, string ownerPassword, Permissions permissions, CryptoAlgorithm cryptoAlgorithm, bool usePdf20)
Parametri
userPassword
string
Password utente.
ownerPassword
string
Password del proprietario.
permissions
Permissions
Permessi del documento, vedere Aspose.Pdf.Document.Permissions per dettagli.
cryptoAlgorithm
CryptoAlgorithm
Algoritmo crittografico, vedere Aspose.Pdf.Document.CryptoAlgorithm per dettagli.
usePdf20
bool
Supporto per la revisione 6 (Estensione 8).
ExportAnnotationsToXfdf(string)
Esporta tutte le annotazioni del documento in un file XFDF
public void ExportAnnotationsToXfdf(string fileName)
Parametri
fileName
string
Nome del file XFDF
ExportAnnotationsToXfdf(Stream)
Esporta tutte le annotazioni del documento in un flusso.
public void ExportAnnotationsToXfdf(Stream stream)
Parametri
stream
Stream
Flusso dove memorizzare XFDF.
Flatten()
Rimuove tutti i campi dal documento e colloca i loro valori al loro posto.
public void Flatten()
Flatten(FlattenSettings)
Rimuove tutti i campi (e annotazioni) dal documento e colloca i loro valori al loro posto.
public void Flatten(Form.FlattenSettings flattenSettings)
Parametri
flattenSettings
Form.FlattenSettings
Impostazioni per il processo di appiattimento.
FlattenTransparency()
Sostituisce il contenuto trasparente con grafica raster e vettoriale non trasparente.
public void FlattenTransparency()
FreeMemory()
Pulisce la memoria
public void FreeMemory()
GetCatalogValue(string)
Restituisce il valore dell’elemento dal dizionario del catalogo.
public object GetCatalogValue(string key)
Parametri
key
string
La chiave dell’elemento.
Restituisce
Valore dell’elemento - se la chiave è stata trovata con successo; altrimenti, null.
GetObjectById(string)
Ottiene un oggetto con l’ID specificato nel documento.
public object GetObjectById(string id)
Parametri
id
string
L’ID dell’oggetto.
Restituisce
L’oggetto con l’ID specificato. Null se l’ID non viene trovato.
GetXmpMetadata(Stream)
Ottiene i metadati XMP dal documento.
public void GetXmpMetadata(Stream stream)
Parametri
stream
Stream
Flusso in cui verranno memorizzati i metadati.
HasIncrementalUpdate()
Controlla se il documento PDF corrente è stato salvato con aggiornamenti incrementali.
public bool HasIncrementalUpdate()
Restituisce
true
se il documento PDF ha aggiornamenti incrementali; altrimenti, false
.
ImportAnnotationsFromXfdf(string)
Importa annotazioni da un file XFDF nel documento.
public void ImportAnnotationsFromXfdf(string fileName)
Parametri
fileName
string
Nome del file XFDF
ImportAnnotationsFromXfdf(Stream)
Importa annotazioni da un flusso nel documento.
public void ImportAnnotationsFromXfdf(Stream stream)
Parametri
stream
Stream
Flusso contenente i dati XFDF.
LoadFrom(string, LoadOptions)
Carica un file, convertendolo in PDF.
public void LoadFrom(string filename, LoadOptions options)
Parametri
filename
string
Il percorso del file da aprire.
options
LoadOptions
Le opzioni di caricamento.
Eccezioni
PdfException
Se il file non può essere caricato.
Se il file non viene trovato.
Merge(MergeOptions, params Document[])
Unisce documenti.
public void Merge(Document.MergeOptions mergeOptions, params Document[] documents)
Parametri
mergeOptions
Document.MergeOptions
Le opzioni di unione.
documents
Document[]
I documenti da unire.
Merge(MergeOptions, params string[])
Unisce documenti.
public void Merge(Document.MergeOptions mergeOptions, params string[] files)
Parametri
mergeOptions
Document.MergeOptions
Le opzioni di unione.
files
string[]
I file pdf da unire.
Merge(params Document[])
Unisce documenti.
public void Merge(params Document[] documents)
Parametri
documents
Document[]
I documenti da unire.
Merge(params string[])
Unisce file pdf.
public void Merge(params string[] files)
Parametri
files
string[]
I file pdf da unire.
MergeDocuments(MergeOptions, params string[])
Unisce documenti.
public static Document MergeDocuments(Document.MergeOptions mergeOptions, params string[] files)
Parametri
mergeOptions
Document.MergeOptions
Le opzioni di unione.
files
string[]
I file pdf da unire.
Restituisce
Il documento unito.
MergeDocuments(MergeOptions, params Document[])
Unisce documenti.
public static Document MergeDocuments(Document.MergeOptions mergeOptions, params Document[] files)
Parametri
mergeOptions
Document.MergeOptions
files
Document[]
I documenti da unire.
Restituisce
Il documento unito.
MergeDocuments(params string[])
Unisce file pdf.
public static Document MergeDocuments(params string[] files)
Parametri
files
string[]
I file pdf da unire.
Restituisce
Il documento unito.
MergeDocuments(params Document[])
Unisce documenti.
public static Document MergeDocuments(params Document[] documents)
Parametri
documents
Document[]
I documenti da unire.
Restituisce
Il documento unito.
Optimize()
Linearizza il documento per
- aprire la prima pagina il più rapidamente possibile;
- visualizzare la pagina successiva o seguire un link alla pagina successiva il più rapidamente possibile;
- visualizzare la pagina in modo incrementale man mano che arriva quando i dati per una pagina vengono consegnati su un canale lento (visualizzare prima i dati più utili);
- consentire interazioni dell’utente, come seguire un link, da eseguire anche prima che l’intera pagina sia stata ricevuta e visualizzata. Invocare questo metodo non salva effettivamente il documento. Al contrario, il documento è solo preparato per avere una struttura ottimizzata, chiamare quindi Salva per ottenere un documento ottimizzato.
public void Optimize()
OptimizeResources()
Ottimizza le risorse nel documento:
- Le risorse non utilizzate nelle pagine del documento vengono rimosse;
- Le risorse uguali vengono unite in un oggetto;
- Gli oggetti non utilizzati vengono eliminati.
public void OptimizeResources()
OptimizeResources(OptimizationOptions)
Ottimizza le risorse nel documento secondo la strategia di ottimizzazione definita.
public void OptimizeResources(OptimizationOptions strategy)
Parametri
strategy
OptimizationOptions
Strategia di ottimizzazione.
PageNodesToBalancedTree(byte)
Organizza i nodi dell’albero delle pagine in un documento in un albero bilanciato. Solo se il documento ha più di nodesNumInSubtrees oggetti pagina, altrimenti non fa nulla. Non chiamare questo metodo mentre si itera su elementi Pages, potrebbe dare risultati imprevedibili.
public void PageNodesToBalancedTree(byte nodesNumInSubtrees = 10)
Parametri
nodesNumInSubtrees
byte
Numero desiderato di subnodi. Il valore predefinito è dieci.
ProcessParagraphs()
Elabora i paragrafi per il generatore.
public void ProcessParagraphs()
RemoveMetadata()
Rimuove i metadati dal documento.
public void RemoveMetadata()
RemovePdfUaCompliance()
Rimuove la conformità pdfUa dal documento
public void RemovePdfUaCompliance()
RemovePdfaCompliance()
Rimuove la conformità pdfa dal documento
public void RemovePdfaCompliance()
Repair()
Ripara il documento danneggiato.
public void Repair()
Save(Stream)
Memorizza il documento nel flusso.
public void Save(Stream output)
Parametri
output
Stream
Flusso in cui il documento deve essere memorizzato.
Save(string)
Salva il documento nel file specificato.
public void Save(string outputFileName)
Parametri
outputFileName
string
Percorso del file in cui il documento sarà memorizzato.
Save()
Salva il documento in modo incrementale (cioè utilizzando la tecnica di aggiornamento incrementale).
public void Save()
Osservazioni
Per salvare il documento in modo incrementale, dobbiamo aprire il file del documento per la scrittura. Pertanto, il Document deve essere inizializzato con un flusso scrivibile come nel seguente frammento di codice: Document doc = new Document(new FileStream(“document.pdf”, FileMode.Open, FileAccess.ReadWrite)); // apportare alcune modifiche e salvare il documento in modo incrementale doc.Save();
Save(SaveOptions)
Salva il documento con opzioni di salvataggio.
public void Save(SaveOptions options)
Parametri
options
SaveOptions
Opzioni di salvataggio.
Save(string, SaveFormat)
Salva il documento con un nuovo nome insieme a un formato di file.
public void Save(string outputFileName, SaveFormat format)
Parametri
outputFileName
string
Percorso del file in cui il documento sarà memorizzato.
format
SaveFormat
Opzioni di formato.
Save(Stream, SaveFormat)
Salva il documento con un nuovo nome insieme a un formato di file.
public void Save(Stream outputStream, SaveFormat format)
Parametri
outputStream
Stream
Flusso in cui il documento sarà memorizzato.
format
SaveFormat
Opzioni di formato.
Eccezioni
System.ArgumentException quando Aspose.Pdf.HtmlSaveOptions viene passato a un metodo. Salvare un documento nel flusso html non è supportato. Si prega di utilizzare il metodo salva nel file.
Save(string, SaveOptions)
Salva il documento con un nuovo nome impostando le opzioni di salvataggio.
public void Save(string outputFileName, SaveOptions options)
Parametri
outputFileName
string
Percorso del file in cui il documento sarà memorizzato.
options
SaveOptions
Opzioni di salvataggio.
Save(Stream, SaveOptions)
Salva il documento in un flusso con opzioni di salvataggio.
public void Save(Stream outputStream, SaveOptions options)
Parametri
outputStream
Stream
Flusso in cui il documento sarà memorizzato.
options
SaveOptions
Opzioni di salvataggio.
Eccezioni
System.ArgumentException quando Aspose.Pdf.HtmlSaveOptions viene passato a un metodo. Salvare un documento nel flusso html non è supportato. Si prega di utilizzare il metodo salva nel file.
SaveAsync(Stream, CancellationToken)
Memorizza il documento nel flusso.
public Task SaveAsync(Stream output, CancellationToken cancellationToken)
Parametri
output
Stream
Flusso in cui il documento deve essere memorizzato.
cancellationToken
CancellationToken
Token di cancellazione.
Restituisce
Compito asincrono.
SaveAsync(string, CancellationToken)
Salva il documento nel file specificato.
public Task SaveAsync(string outputFileName, CancellationToken cancellationToken)
Parametri
outputFileName
string
Percorso del file in cui il documento sarà memorizzato.
cancellationToken
CancellationToken
Token di cancellazione.
Restituisce
Compito asincrono.
SaveAsync(CancellationToken)
Salva il documento in modo incrementale (cioè utilizzando la tecnica di aggiornamento incrementale).
public Task SaveAsync(CancellationToken cancellationToken)
Parametri
cancellationToken
CancellationToken
Token di cancellazione.
Restituisce
Compito asincrono.
Osservazioni
Per salvare il documento in modo incrementale, dobbiamo aprire il file del documento per la scrittura. Pertanto, il Document deve essere inizializzato con un flusso scrivibile come nel seguente frammento di codice: Document doc = new Document(new FileStream(“document.pdf”, FileMode.Open, FileAccess.ReadWrite)); // apportare alcune modifiche e salvare il documento in modo incrementale doc.Save();
SaveAsync(SaveOptions, CancellationToken)
Salva il documento con opzioni di salvataggio.
public Task SaveAsync(SaveOptions options, CancellationToken cancellationToken)
Parametri
options
SaveOptions
Opzioni di salvataggio.
cancellationToken
CancellationToken
Token di cancellazione.
Restituisce
Compito asincrono.
SaveAsync(string, SaveFormat, CancellationToken)
Salva il documento con un nuovo nome insieme a un formato di file.
public Task SaveAsync(string outputFileName, SaveFormat format, CancellationToken cancellationToken)
Parametri
outputFileName
string
Percorso del file in cui il documento sarà memorizzato.
format
SaveFormat
Opzioni di formato.
cancellationToken
CancellationToken
Token di cancellazione.
Restituisce
Compito asincrono.
SaveAsync(Stream, SaveFormat, CancellationToken)
Salva il documento con un nuovo nome insieme a un formato di file.
public Task SaveAsync(Stream outputStream, SaveFormat format, CancellationToken cancellationToken)
Parametri
outputStream
Stream
Flusso in cui il documento sarà memorizzato.
format
SaveFormat
Opzioni di formato.
cancellationToken
CancellationToken
Token di cancellazione.
Restituisce
Compito asincrono.
Eccezioni
System.ArgumentException quando Aspose.Pdf.HtmlSaveOptions viene passato a un metodo. Salvare un documento nel flusso html non è supportato. Si prega di utilizzare il metodo salva nel file.
SaveAsync(string, SaveOptions, CancellationToken)
Salva il documento con un nuovo nome impostando le opzioni di salvataggio.
public Task SaveAsync(string outputFileName, SaveOptions options, CancellationToken cancellationToken)
Parametri
outputFileName
string
Percorso del file in cui il documento sarà memorizzato.
options
SaveOptions
Opzioni di salvataggio.
cancellationToken
CancellationToken
Token di cancellazione.
Restituisce
Compito asincrono.
SaveAsync(Stream, SaveOptions, CancellationToken)
Salva il documento in un flusso con opzioni di salvataggio.
public Task SaveAsync(Stream outputStream, SaveOptions options, CancellationToken cancellationToken)
Parametri
outputStream
Stream
Flusso in cui il documento sarà memorizzato.
`options