Document

Document class

Rappresenta un documento Word.

Per saperne di più, visita ilLavorare con il documento articolo di documentazione.

public class Document : DocumentBase

Costruttori

NomeDescrizione
Document()Crea un documento Word vuoto.
Document(Stream)Apre un documento esistente da un flusso. Rileva automaticamente il formato del file.
Document(string)Apre un documento esistente da un file. Rileva automaticamente il formato del file.
Document(Stream, LoadOptions)Apre un documento esistente da un flusso. Permette di specificare opzioni aggiuntive come una password di crittografia.
Document(string, LoadOptions)Apre un documento esistente da un file. Permette di specificare opzioni aggiuntive come una password di crittografia.

Proprietà

NomeDescrizione
AttachedTemplate { get; set; }Ottiene o imposta il percorso completo del modello allegato al documento.
AutomaticallyUpdateStyles { get; set; }Ottiene o imposta un flag che indica se gli stili nel documento vengono aggiornati per corrispondere agli stili nel modello allegato ogni volta che il documento viene aperto in MS Word.
BackgroundShape { get; set; }Ottiene o imposta la forma dello sfondo del documento. Può esserenull .
Bibliography { get; }Ottiene ilBibliographyoggetto che rappresenta l’elenco delle fonti disponibili nel documento.
BuiltInDocumentProperties { get; }Restituisce una raccolta che rappresenta tutte le proprietà integrate del documento.
CompatibilityOptions { get; }Fornisce accesso alle opzioni di compatibilità dei documenti (ovvero le preferenze dell’utente immesse nelCompatibilità scheda delOpzionidialogo in Word).
Compliance { get; }Ottiene la versione di conformità OOXML determinata dal contenuto del documento caricato. Ha senso solo per i documenti OOXML.
Count { get; }Ottiene il numero di figli immediati di questo nodo.
CustomDocumentProperties { get; }Restituisce una raccolta che rappresenta tutte le proprietà personalizzate del documento.
CustomNodeId { get; set; }Specifica l’identificatore del nodo personalizzato.
CustomXmlParts { get; set; }Ottiene o imposta la raccolta di parti di archiviazione dati XML personalizzate.
DefaultTabStop { get; set; }Ottiene o imposta l’intervallo (in punti) tra le tabulazioni predefinite.
DigitalSignatures { get; }Ottiene la raccolta di firme digitali per questo documento e i relativi risultati di convalida.
override Document { get; }Ottiene questa istanza.
EndnoteOptions { get; }Fornisce opzioni che controllano la numerazione e il posizionamento delle note di chiusura in questo documento.
FieldOptions { get; }Ottiene unFieldOptions oggetto che rappresenta le opzioni per controllare la gestione dei campi nel documento.
FirstChild { get; }Ottiene il primo figlio del nodo.
FirstSection { get; }Ottiene la prima sezione del documento.
FontInfos { get; }Fornisce l’accesso alle proprietà dei font utilizzati in questo documento.
FontSettings { get; set; }Ottiene o imposta le impostazioni del font del documento.
FootnoteOptions { get; }Fornisce opzioni che controllano la numerazione e il posizionamento delle note a piè di pagina in questo documento.
FootnoteSeparators { get; }Fornisce l’accesso ai separatori di note a piè di pagina/note di chiusura definiti nel documento.
Frameset { get; }Restituisce unFrameset istanza se questo documento rappresenta una pagina frame.
GlossaryDocument { get; set; }Ottiene o imposta il documento di glossario all’interno di questo documento o modello. Un documento di glossario è un archivio per le voci di Testo automatico, Correzione automatica e Building Block definite in un documento.
GrammarChecked { get; set; }RestituisceVERO se il documento è stato controllato grammaticalmente.
HasChildNodes { get; }RestituisceVERO se questo nodo ha nodi figlio.
HasMacros { get; }RestituisceVERO se il documento ha un progetto VBA (macro).
HasRevisions { get; }RestituisceVERO se il documento presenta delle modifiche tracciate.
HyphenationOptions { get; }Fornisce accesso alle opzioni di sillabazione del documento.
IncludeTextboxesFootnotesEndnotesInStat { get; set; }Specifica se includere caselle di testo, note a piè di pagina e note di chiusura nelle statistiche del conteggio delle parole.
override IsComposite { get; }RestituisceVERO poiché questo nodo può avere nodi figlio.
JustificationMode { get; set; }Ottiene o imposta la regolazione della spaziatura dei caratteri di un documento.
LastChild { get; }Ottiene l’ultimo figlio del nodo.
LastSection { get; }Ottiene l’ultima sezione del documento.
LayoutOptions { get; }Ottiene unLayoutOptions oggetto che rappresenta le opzioni per controllare il processo di layout di questo documento.
Lists { get; }Fornisce l’accesso alla formattazione dell’elenco utilizzata nel documento.
MailMerge { get; }Restituisce unMailMerge oggetto che rappresenta la funzionalità di unione di posta per il documento.
MailMergeSettings { get; set; }Ottiene o imposta l’oggetto che contiene tutte le informazioni di unione di stampa per un documento.
NextSibling { get; }Ottiene il nodo immediatamente successivo a questo nodo.
NodeChangingCallback { get; set; }Chiamato quando un nodo viene inserito o rimosso nel documento.
override NodeType { get; }RestituisceDocument .
OriginalFileName { get; }Ottiene il nome del file originale del documento.
OriginalLoadFormat { get; }Ottiene il formato del documento originale caricato in questo oggetto.
PackageCustomParts { get; set; }Ottiene o imposta la raccolta di parti personalizzate (contenuto arbitrario) collegate al pacchetto OOXML tramite “relazioni sconosciute”.
PageColor { get; set; }Ottiene o imposta il colore della pagina del documento. Questa proprietà è una versione semplificata diBackgroundShape .
PageCount { get; }Ottiene il numero di pagine nel documento calcolato dall’operazione di impaginazione più recente.
ParentNode { get; }Ottiene il genitore immediato di questo nodo.
PreviousSibling { get; }Ottiene il nodo immediatamente precedente questo nodo.
ProtectionType { get; }Ottiene il tipo di protezione del documento attualmente attivo.
PunctuationKerning { get; set; }Specifica se la crenatura si applica sia al testo latino che alla punteggiatura.
Range { get; }Restituisce unRangeoggetto che rappresenta la porzione di un documento contenuta in questo nodo.
RemovePersonalInformation { get; set; }Ottiene o imposta un flag che indica che Microsoft Word rimuoverà tutte le informazioni utente dai commenti, dalle revisioni e dalle proprietà del documento al momento del salvataggio del documento.
ResourceLoadingCallback { get; set; }Consente di controllare come vengono caricate le risorse esterne.
Revisions { get; }Ottiene una raccolta di revisioni (modifiche tracciate) presenti in questo documento.
RevisionsView { get; set; }Ottiene o imposta un valore che indica se lavorare con la versione originale o rivista di un documento.
Sections { get; }Restituisce una raccolta che rappresenta tutte le sezioni del documento.
ShadeFormData { get; set; }Specifica se attivare l’ombreggiatura grigia sui campi del modulo.
ShowGrammaticalErrors { get; set; }Specifica se visualizzare gli errori grammaticali in questo documento.
ShowSpellingErrors { get; set; }Specifica se visualizzare gli errori di ortografia in questo documento.
SpellingChecked { get; set; }RestituisceVERO se il documento è stato controllato per l’ortografia.
Styles { get; }Restituisce una raccolta di stili definiti nel documento.
Theme { get; }Ottiene ilTheme oggetto per questo documento.
TrackRevisions { get; set; }Vero se le modifiche vengono tracciate quando questo documento viene modificato in Microsoft Word.
Variables { get; }Restituisce la raccolta di variabili aggiunte a un documento o a un modello.
VbaProject { get; set; }Ottiene o imposta unVbaProject .
VersionsCount { get; }Ottiene il numero di versioni del documento memorizzate nel documento DOC.
ViewOptions { get; }Fornisce opzioni per controllare la modalità di visualizzazione del documento in Microsoft Word.
WarningCallback { get; set; }Chiamato durante varie procedure di elaborazione dei documenti quando viene rilevato un problema che potrebbe causare una perdita di fedeltà dei dati o della formattazione.
Watermark { get; }Fornisce accesso alla filigrana del documento.
WebExtensionTaskPanes { get; }Restituisce una raccolta che rappresenta un elenco di componenti aggiuntivi del riquadro attività.
WriteProtection { get; }Fornisce accesso alle opzioni di protezione da scrittura del documento.

Metodi

NomeDescrizione
override Accept(DocumentVisitor)Accetta un visitatore.
AcceptAllRevisions()Accetta tutte le modifiche tracciate nel documento.
override AcceptEnd(DocumentVisitor)Accetta un visitatore per aver visitato la fine del documento.
override AcceptStart(DocumentVisitor)Accetta un visitatore per aver visitato l’inizio del documento.
AppendChild<T>(T)Aggiunge il nodo specificato alla fine dell’elenco dei nodi figlio per questo nodo.
AppendDocument(Document, ImportFormatMode)Aggiunge il documento specificato alla fine di questo documento.
AppendDocument(Document, ImportFormatMode, ImportFormatOptions)Aggiunge il documento specificato alla fine di questo documento.
Cleanup()Pulisce gli stili e gli elenchi non utilizzati dal documento.
Cleanup(CleanupOptions)Pulisce gli stili e gli elenchi non utilizzati dal documento in base a quanto specificatoCleanupOptions .
Clone()Esegue una copia profonda delDocument .
Clone(bool)Crea un duplicato del nodo.
Compare(Document, string, DateTime)Confronta questo documento con un altro documento che produce modifiche come numero di revisioni di modifica e formatoRevision .
Compare(Document, string, DateTime, CompareOptions)Confronta questo documento con un altro documento che produce modifiche come un numero di revisioni di modifica e formatoRevision . Consente di specificare le opzioni di confronto utilizzandoCompareOptions .
CopyStylesFromTemplate(Document)Copia gli stili dal modello specificato a un documento.
CopyStylesFromTemplate(string)Copia gli stili dal modello specificato a un documento.
CreateNavigator()Crea un navigatore che può essere utilizzato per attraversare e leggere i nodi.
EnsureMinimum()Se il documento non contiene sezioni, crea una sezione con un paragrafo.
ExpandTableStylesToDirectFormatting()Converte la formattazione specificata negli stili di tabella in formattazione diretta sulle tabelle nel documento.
ExtractPages(int, int)Restituisce ilDocument oggetto che rappresenta un intervallo specificato di pagine.
GetAncestor(NodeType)Ottiene il primo antenato dell’oggetto specificatoNodeType .
GetAncestor(Type)Ottiene il primo antenato del tipo di oggetto specificato.
GetChild(NodeType, int, bool)Restituisce un N-esimo nodo figlio che corrisponde al tipo specificato.
GetChildNodes(NodeType, bool)Restituisce una raccolta live di nodi figlio che corrispondono al tipo specificato.
GetEnumerator()Fornisce supporto per ogni iterazione di stile sui nodi figlio di questo nodo.
GetPageInfo(int)Ottiene le dimensioni della pagina, l’orientamento e altre informazioni su una pagina che potrebbero essere utili per la stampa o il rendering.
override GetText()Ottiene il testo di questo nodo e di tutti i suoi figli.
ImportNode(Node, bool)Importa un nodo da un altro documento al documento corrente.
ImportNode(Node, bool, ImportFormatMode)Importa un nodo da un altro documento nel documento corrente con un’opzione per controllare la formattazione.
IndexOf(Node)Restituisce l’indice del nodo figlio specificato nell’array dei nodi figlio.
InsertAfter<T>(T, Node)Inserisce il nodo specificato subito dopo il nodo di riferimento specificato.
InsertBefore<T>(T, Node)Inserisce il nodo specificato immediatamente prima del nodo di riferimento specificato.
JoinRunsWithSameFormatting()Unisce le esecuzioni con la stessa formattazione in tutti i paragrafi del documento.
NextPreOrder(Node)Ottiene il nodo successivo in base all’algoritmo di attraversamento dell’albero preordinato.
NormalizeFieldTypes()Modifica i valori del tipo di campoFieldType DiFieldStart ,FieldSeparator ,FieldEnd nell’intero documento in modo che corrispondano ai tipi di campo contenuti nei codici di campo.
PrependChild<T>(T)Aggiunge il nodo specificato all’inizio dell’elenco dei nodi figlio per questo nodo.
PreviousPreOrder(Node)Ottiene il nodo precedente secondo l’algoritmo di attraversamento dell’albero preordinato.
Print()Stampa l’intero documento sulla stampante predefinita.
Print(PrinterSettings)Stampa il documento in base alle impostazioni di stampa specificate, utilizzando il controller di stampa standard (senza interfaccia utente).
Print(string)Stampa l’intero documento sulla stampante specificata, utilizzando il controller di stampa standard (senza interfaccia utente).
Print(PrinterSettings, string)Stampa il documento in base alle impostazioni di stampa specificate, utilizzando il controller di stampa standard (senza interfaccia utente) e un nome di documento.
Protect(ProtectionType)Protegge il documento dalle modifiche senza modificare la password esistente o assegna una password casuale.
Protect(ProtectionType, string)Protegge il documento dalle modifiche e, facoltativamente, imposta una password di protezione.
Remove()Si rimuove dal genitore.
RemoveAllChildren()Rimuove tutti i nodi figlio del nodo corrente.
RemoveBlankPages()Rimuove le pagine vuote dal documento.
RemoveChild<T>(T)Rimuove il nodo figlio specificato.
RemoveExternalSchemaReferences()Rimuove i riferimenti allo schema XML esterno da questo documento.
RemoveMacros()Rimuove tutte le macro (il progetto VBA), nonché le barre degli strumenti e le personalizzazioni dei comandi dal documento.
RemoveSmartTags()Rimuove tuttoSmartTag nodi discendenti del nodo corrente.
RenderToScale(int, Graphics, float, float, float)Rende una pagina del documento in unGraphics oggetto a una scala specificata.
RenderToSize(int, Graphics, float, float, float, float)Rende una pagina del documento in unGraphics oggetto a una dimensione specificata.
Save(string)Salva il documento in un file. Determina automaticamente il formato di salvataggio in base all’estensione.
Save(Stream, SaveFormat)Salva il documento in un flusso utilizzando il formato specificato.
Save(Stream, SaveOptions)Salva il documento in un flusso utilizzando le opzioni di salvataggio specificate.
Save(string, SaveFormat)Salva il documento in un file nel formato specificato.
Save(string, SaveOptions)Salva il documento in un file utilizzando le opzioni di salvataggio specificate.
Save(HttpResponse, string, ContentDisposition, SaveOptions)Invia il documento al browser client.
SelectNodes(string)Seleziona un elenco di nodi che corrispondono all’espressione XPath.
SelectSingleNode(string)Seleziona il primoNode che corrisponde all’espressione XPath.
StartTrackRevisions(string)Inizia a contrassegnare automaticamente tutte le ulteriori modifiche apportate al documento a livello di programmazione come modifiche di revisione.
StartTrackRevisions(string, DateTime)Inizia a contrassegnare automaticamente tutte le ulteriori modifiche apportate al documento a livello di programmazione come modifiche di revisione.
StopTrackRevisions()Interrompe la marcatura automatica delle modifiche al documento come revisioni.
ToString(SaveFormat)Esporta il contenuto del nodo in una stringa nel formato specificato.
ToString(SaveOptions)Esporta il contenuto del nodo in una stringa utilizzando le opzioni di salvataggio specificate.
UnlinkFields()Scollega i campi nell’intero documento.
Unprotect()Rimuove la protezione dal documento indipendentemente dalla password.
Unprotect(string)Rimuove la protezione dal documento se viene specificata una password corretta.
UpdateActualReferenceMarks()Aggiorna ilActualReferenceMark proprietà di tutte le note a piè di pagina e di chiusura nel documento.
UpdateFields()Aggiorna i valori dei campi nell’intero documento.
UpdateListLabels()Aggiorna le etichette degli elenchi per tutti gli elementi degli elenchi nel documento.
UpdatePageLayout()Ricostruisce il layout di pagina del documento.
UpdateThumbnail()AggiornamentiThumbnail del documento utilizzando le opzioni predefinite.
UpdateThumbnail(ThumbnailGeneratingOptions)AggiornamentiThumbnail del documento in base alle opzioni specificate.
UpdateWordCount()Aggiorna le proprietà del conteggio delle parole del documento.
UpdateWordCount(bool)Aggiorna le proprietà del conteggio delle parole del documento, facoltativamente aggiornaLines proprietà.

Osservazioni

ILDocument è un oggetto centrale nella libreria Aspose.Words.

Per caricare un documento esistente in uno qualsiasi deiLoadFormat formati, passare un nome di file o un flusso in uno deiDocument costruttori. Per creare un documento vuoto, chiamare il costruttore senza parametri.

Utilizzare uno dei sovraccarichi del metodo Save per salvare il documento in uno qualsiasi dei SaveFormat formati.

Per disegnare le pagine del documento direttamente su unGrafica oggetto use RenderToScale ORenderToSize metodo.

Per stampare il documento, utilizzare uno deiPrint metodi.

MailMergeè il motore di reporting di Aspose.Words che consente di popolare report progettati in Microsoft Word con dati provenienti da varie fonti dati in modo rapido e semplice. I dati possono provenire da un DataSet, DataTable, DataView, IDataReader o da un array di valori.Stampa unione esaminerà i record trovati nell’origine dati e li inserirà nei campi di unione del documento, ampliandolo se necessario.

Document memorizza informazioni a livello di documento comeStyles , BuiltInDocumentProperties ,CustomDocumentProperties , elenchi e macro. La maggior parte di questi oggetti sono accessibili tramite le proprietà corrispondenti delDocument.

ILDocument è un nodo radice di un albero che contiene tutti gli altri nodi del documento. L’albero è un pattern di progettazione composito e per molti versi è simile a XmlDocument. Il contenuto del documento può essere manipolato liberamente a livello di programmazione:

  • È possibile accedere ai nodi del documento tramite raccolte tipizzate, ad esempioSections , ParagraphCollection ecc.
  • nodi del documento possono essere selezionati in base al tipo di nodo utilizzando GetChildNodes o utilizzando una query XPath conSelectNodes OSelectSingleNode.
  • I nodi di contenuto possono essere aggiunti o rimossi da qualsiasi punto del documento utilizzando InsertBefore ,InsertAfter , RemoveChild e altri metodi forniti dalla classe baseCompositeNode.
  • Gli attributi di formattazione di ciascun nodo possono essere modificati tramite le proprietà del nodo stesso.

Considerare l’utilizzoDocumentBuilder che semplifica il compito di creare o di popolare l’albero dei documenti a livello di programmazione.

ILDocument può contenere soloSection oggetti.

In Microsoft Word, un documento valido deve contenere almeno una sezione.

Esempi

Mostra come eseguire una stampa unione con i dati di una DataTable.

public void ExecuteDataTable()
{
    DataTable table = new DataTable("Test");
    table.Columns.Add("CustomerName");
    table.Columns.Add("Address");
    table.Rows.Add(new object[] { "Thomas Hardy", "120 Hanover Sq., London" });
    table.Rows.Add(new object[] { "Paolo Accorti", "Via Monte Bianco 34, Torino" });

    // Di seguito sono riportati due modi per utilizzare una DataTable come origine dati per una stampa unione.
    // 1 - Utilizza l'intera tabella per la stampa unione per creare un documento di stampa unione in output per ogni riga della tabella:
    Document doc = CreateSourceDocExecuteDataTable();

    doc.MailMerge.Execute(table);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.WholeTable.docx");

    // 2 - Utilizzare una riga della tabella per creare un documento di stampa unione in output:
    doc = CreateSourceDocExecuteDataTable();

    doc.MailMerge.Execute(table.Rows[1]);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.OneRow.docx");
}

/// <summary>
/// Crea un documento sorgente per la stampa unione.
/// </summary>
private static Document CreateSourceDocExecuteDataTable()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    builder.InsertField(" MERGEFIELD CustomerName ");
    builder.InsertParagraph();
    builder.InsertField(" MERGEFIELD Address ");

    return doc;
}

Guarda anche

ConvertUtil Class DocumentBase Class