Class Document

Class Document

Namespace: Aspose.Pdf
Assembly: Aspose.PDF.dll

Classe che rappresenta un documento PDF

public sealed class Document : IDisposable

Ereditarietà

objectDocument

Implementa

IDisposable

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

byte

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à

bool

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à

bool

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à

bool

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à

bool

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à

bool

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à

bool

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à

bool

FileName

Nome del file PDF che ha causato questo documento

public string FileName { get; }

Valore della proprietà

string

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à

bool

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à

bool

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à

bool

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à

bool

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à

bool

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à

bool

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à

bool

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à

bool

IsLinearized

Ottiene o imposta un valore che indica se il documento è linearizzato.

public bool IsLinearized { get; set; }

Valore della proprietà

bool

IsPdfUaCompliant

Ottiene se il documento è conforme a pdfua.

public bool IsPdfUaCompliant { get; }

Valore della proprietà

bool

IsPdfaCompliant

Ottiene se il documento è conforme a pdfa.

public bool IsPdfaCompliant { get; }

Valore della proprietà

bool

IsXrefGapsAllowed

Ottiene o imposta se il documento è conforme a pdfa.

public bool IsXrefGapsAllowed { get; set; }

Valore della proprietà

bool

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à

bool

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à

int

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à

bool

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à

string

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

MemoryStream

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

object

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

object

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

bool

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.

FileNotFoundException

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

Document

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

Document

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

Document

Il documento unito.

MergeDocuments(params Document[])

Unisce documenti.

public static Document MergeDocuments(params Document[] documents)

Parametri

documents Document[]

I documenti da unire.

Restituisce

Document

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:

  1. Le risorse non utilizzate nelle pagine del documento vengono rimosse;
  2. Le risorse uguali vengono unite in un oggetto;
  3. 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

ArgumentException

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

ArgumentException

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

Task

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

Task

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

Task

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

Task

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

Task

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

Task

Compito asincrono.

Eccezioni

ArgumentException

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

Task

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

 Italiano