Class Document
Il nome: Aspose.Words Assemblea: Aspose.Words.dll (25.4.0)
Presentazione di un documento Word.
Per saperne di più, visita il Working with Document Articolo di documentazione.
public class Document : DocumentBase, IEnumerable<node>, IEnumerable, IXPathNavigable
Inheritance
object ← Node ← CompositeNode ← DocumentBase ← Document
Implements
IEnumerable
I membri ereditari
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
Aspose.Words.Document è un oggetto centrale nella libreria di Aspose.Words.
Per caricare un documento esistente in uno dei formati Aspose.Words.LoadFormat, passare un nome di file o un flusso in uno degli Aspose.Words.Document constructors. Per creare un documento bianco, chiamare il constructor senza parametri.
Utilizzare uno dei metodi di salvataggio per salvare il documento in uno dei formati Aspose.Words.SaveFormat.
Per disegnare pagine documentali direttamente su un oggetto utilizza Aspose.Words.Document.RenderToScale(System.Int32,System.Drawing.Graphics,System.Single,System.Single,System.Single) o Aspose.Words.Document.RenderToSize(System.Int32,System.Drawing.Graphics,System.Single,System.Single,System.Single,System.Single) metodo.
Per stampare il documento, utilizzare uno dei metodi Aspose.Words.Document.Print(System.String).
Aspose.Words.Document.MailMerge è il motore di segnalazione di Wl26 che consente di localizzare i rapporti progettati in Microsoft Word con i dati provenienti da varie fonti di dati rapidamente e facilmente. I dati possono essere da un DataSet, DataTable, dataView, IDataReader o una serie di valori. passerà attraverso i record trovati nella fonte dei dati e inserirli nei campi di fusione di posta nel documento che lo sviluppa come necessario.
Aspose.Words.Document memorizza informazioni in tutto il documento, come _ www.wl26_.document Base.Styles, _wll26 _.dokument.BuiltInDokumentProperties, wla_26.docent.customDOCumentPropers, elenchi e macro.La maggior parte di questi oggetti sono accessibili attraverso le proprietà corrispondenti del Wl25 .Dicument
L’Aspose.Words.Document è un nodo radicale di un albero che contiene tutti gli altri nodo del documento.L’albero è un modello di design composito e in molti modi simile a XmlDocument.Il contenuto del documento può essere manipolato liberamente programmaticamente:
- I nodi del documento possono essere accessibili tramite collezioni stampate, ad esempio Aspose.Words.Document.Sections, Aspose.Words.ParagraphCollection, ecc.
- I nodi del documento possono essere selezionati per il loro tipo di nodi utilizzando Aspose.Words.CompositeNode.GetChildNodes(Aspose.Words.NodeType,System.Boolean) o utilizzando una query XPath con Aspose.Words.CompositeNode.SelectNodes(System.String) o Aspose.Words.CompositeNode.SelectSingleNode(System.String).
- I nodi di contenuto possono essere aggiunti o rimossi da qualsiasi parte del documento utilizzando Aspose.Words.CompositeNode.InsertBefore’‘1(‘‘0,Aspose.Words.Node), Aspose.Words.CompositeNode.InsertAfter’‘1(‘‘0,Aspose.Words.Node), Aspose.Words.CompositeNode.RemoveChild’‘1(‘‘0) e altri metodi forniti dalla classe di base Aspose.Words.CompositeNode.
- Gli attributi di formattazione di ciascun nodo possono essere modificati attraverso le proprietà di quel nodo.
Considerare l’utilizzo di Aspose.Words.DocumentBuilder che semplifica il compito di creare o populare programmaticamente l’albero del documento.
Il documento Aspose.Words.Document può contenere solo gli oggetti Aspose.Words.Sezione.
In Microsoft Word, un documento valido deve avere almeno una sezione.
Constructors
Document()
Crea un documento Word bianco.
public Document()
Remarks
Un documento vuoto viene recuperato dalle risorse, e per impostazione predefinita, il documento risultante appare più simile a quello creato da Aspose.Words.Settings.MsWordVersion.Word2007.
Il metodo Aspose.Words.Settings.CompatibilityOptions.OptimizeFor(W L 26.MsWordVersion) può essere utilizzato per ottimizzare il contenuto del documento nonché il comportamento predefinito __ WL 26_ per una versione specifica di MS Word.
La dimensione del documento è Letter by default.Se si desidera modificare la configurazione della pagina, utilizzare Aspose.Words.Section.PageSetup.
Dopo la creazione, è possibile utilizzare Aspose.Words.DocumentBuilder per aggiungere facilmente il contenuto del documento.
Document(String)
Apri un documento esistente da un file. rileva automaticamente il formato del file.
public Document(string fileName)
Parameters
fileName
string
Nome del file del documento da aprire.
Exceptions
UnsupportedFileFormatException
Il formato del documento non è riconosciuto o supportato.
Il documento sembra essere corrotto e non può essere caricato.
C’è un problema con il documento e dovrebbe essere segnalato agli sviluppatori di Aspose.Words.
C’è un’eccezione di input/output.
Il documento è crittografato e richiede una password per aprire, ma hai fornito una password sbagliata.
Il nome del file non può essere nullo o vuoto.
Document(String, LoadOptions)
Apri un documento esistente da un file. consente di specificare ulteriori opzioni come una password di crittografia.
public Document(string fileName, LoadOptions loadOptions)
Parameters
fileName
string
Nome del file del documento da aprire.
loadOptions
LoadOptions
Opzioni aggiuntive da utilizzare quando si carica un documento. può essere ‘zero’.
Exceptions
UnsupportedFileFormatException
Il formato del documento non è riconosciuto o supportato.
Il documento sembra essere corrotto e non può essere caricato.
C’è un problema con il documento e dovrebbe essere segnalato agli sviluppatori di Aspose.Words.
C’è un’eccezione di input/output.
Il documento è crittografato e richiede una password per aprire, ma hai fornito una password sbagliata.
Il nome del file non può essere nullo o vuoto.
Document(Stream)
Apri un documento esistente da un flusso. rileva automaticamente il formato del file.
public Document(Stream stream)
Parameters
stream
Stream
Stream da dove caricare il documento.
Remarks
Il documento deve essere immagazzinato all’inizio del flusso. il fluso deve supportare la posizione casuale.
Exceptions
UnsupportedFileFormatException
Il formato del documento non è riconosciuto o supportato.
Il documento sembra essere corrotto e non può essere caricato.
C’è un problema con il documento e dovrebbe essere segnalato agli sviluppatori di Aspose.Words.
C’è un’eccezione di input/output.
Il documento è crittografato e richiede una password per aprire, ma hai fornito una password sbagliata.
Il flusso non può essere zero.
Il flusso non supporta la lettura o la ricerca.
Il flusso è un oggetto disperso.
Document(LoadOptions e LoadOptions)
Apri un documento esistente da un flusso. consente di specificare ulteriori opzioni come una password di crittografia.
public Document(Stream stream, LoadOptions loadOptions)
Parameters
stream
Stream
Il flusso da dove caricare il documento.
loadOptions
LoadOptions
Opzioni aggiuntive da utilizzare quando si carica un documento. può essere ‘zero’.
Remarks
Il documento deve essere immagazzinato all’inizio del flusso. il fluso deve supportare la posizione casuale.
Exceptions
UnsupportedFileFormatException
Il formato del documento non è riconosciuto o supportato.
Il documento sembra essere corrotto e non può essere caricato.
C’è un problema con il documento e dovrebbe essere segnalato agli sviluppatori di Aspose.Words.
C’è un’eccezione di input/output.
Il documento è crittografato e richiede una password per aprire, ma hai fornito una password sbagliata.
Il flusso non può essere zero.
Il flusso non supporta la lettura o la ricerca.
Il flusso è un oggetto disperso.
Properties
AttachedTemplate
Riceve o impone il percorso completo del modello allegato al documento.
public string AttachedTemplate { get; set; }
Valore di proprietà
Remarks
La riga vuota significa che il documento è allegato al modello normale.
Aspose.Words.Properties.BuiltInDocumentProperties.Template
Exceptions
Trovare se si tenta di impostare a un valore ‘zero’.
AutomaticallyUpdateStyles
Riceve o mette una bandiera indicando se gli stili nel documento sono aggiornati per corrispondere agli stili nel documento.Il modello è allegato ogni volta che il documento viene aperto in MS Word.
public bool AutomaticallyUpdateStyles { get; set; }
Valore di proprietà
Bibliography
Riceve l’oggetto Aspose.Words.Document.Bibliografia che rappresenta la lista delle fonti disponibili nel documento.
public Bibliography Bibliography { get; }
Valore di proprietà
BuiltInDocumentProperties
Ritorna una collezione che rappresenta tutte le proprietà del documento incorporato.
public BuiltInDocumentProperties BuiltInDocumentProperties { get; }
Valore di proprietà
CompatibilityOptions
Fornisce accesso alle opzioni di compatibilità dei documenti (cioè le preferenze dell’utente inserite nella CompatibilityIl tab della Options Il dialogo in parola).
public CompatibilityOptions CompatibilityOptions { get; }
Valore di proprietà
Compliance
Riceve la versione di conformità OOXML determinata dal contenuto del documento caricato.Fare senso solo per i documenti OOXML.
public OoxmlCompliance Compliance { get; }
Valore di proprietà
Remarks
Se si crea un nuovo documento vuoto o si carica un documento non OOXML ritorna il valore Aspose.Words.Saving.OoxmlCompliance.Ecma376_2006.
CustomDocumentProperties
Ritorna una collezione che rappresenta tutte le proprietà del documento personalizzato.
public CustomDocumentProperties CustomDocumentProperties { get; }
Valore di proprietà
CustomXmlParts
Riceve o impone la raccolta di parti di archiviazione dati XML personalizzate.
public CustomXmlPartCollection CustomXmlParts { get; set; }
Valore di proprietà
Remarks
Aspose.Words carica e salva le parti XML personalizzate solo nei documenti OOXML e DOC.
Questa proprietà non può essere.
Aspose.Words.Markup.CustomXmlPart
DefaultTabStop
Riceve o impone l’intervallo (in punti) tra le stop della scheda predefinita.
public double DefaultTabStop { get; set; }
Valore di proprietà
Vedi anche
DigitalSignatures
Riceve la raccolta delle firme digitali per questo documento e i loro risultati di validazione.
public DigitalSignatureCollection DigitalSignatures { get; }
Valore di proprietà
Remarks
Questa collezione contiene firme digitali che sono state caricate dal documento originale.Queste firme digitali non saranno salvate quando si salva questo Aspose.Words.Document oggetto in un file o flusso perché il salvataggio o la conversione produrrà un documento che è diverso dall’originale e le firme digitali originali non saranno più valide.
Se il documento non è firmato, contiene elementi zero.
EndnoteOptions
Fornisce opzioni che controllano il numero e la posizione delle endnotes in questo documento.
public EndnoteOptions EndnoteOptions { get; }
Valore di proprietà
FieldOptions
Riceve un oggetto Aspose.Words.Fields.FieldOptions che rappresenta le opzioni per controllare la gestione del campo nel documento.
public FieldOptions FieldOptions { get; }
Valore di proprietà
FirstSection
Ricevi la prima sezione del documento.
public Section FirstSection { get; }
Valore di proprietà
Remarks
Ritorna “null” se non ci sono sezioni.
FontSettings
Ottieni o impostate le impostazioni di font del documento.
public FontSettings FontSettings { get; set; }
Valore di proprietà
Remarks
Questa proprietà consente di specificare le impostazioni di font per documento. se impostato a , impostazioni di font statico predefinito Aspose.Words.Fonts.FontSettings.DefaultInstance sarà utilizzato.
Il valore default è.
FootnoteOptions
Fornisce opzioni che controllano il numero e la posizione delle note di fondo in questo documento.
public FootnoteOptions FootnoteOptions { get; }
Valore di proprietà
Frameset
Ritorna un esempio Aspose.Words.Document.Frameset se questo documento rappresenta una pagina di frames.
public Frameset Frameset { get; }
Valore di proprietà
Remarks
Se il documento non è frammentato, la proprietà ha il valore ‘zero’.
GlossaryDocument
Riceve o mette il documento glossario all’interno di questo documento o modello. Un documento glossario è un archivioper le entrate AutoText, AutoCorrect e Building Block definite in un documento.
public GlossaryDocument GlossaryDocument { get; set; }
Valore di proprietà
Remarks
Questa proprietà viene restituita se il documento non ha un documento glossario.
È possibile aggiungere un documento glossario a un documento creando un oggetto Aspose.Words.BuildingBlocks.GlossaryDocument e assegnando a questa proprietà.
Aspose.Words.BuildingBlocks.GlossaryDocumento
GrammarChecked
Ritorna ‘verità’ se il documento è stato controllato per la grammatica.
public bool GrammarChecked { get; set; }
Valore di proprietà
Remarks
Per riconquistare la grammatica nel documento, impostare questa proprietà a “falso”.
HasMacros
Ritorna ‘verità’ se il documento ha un progetto VBA (macros).
public bool HasMacros { get; }
Valore di proprietà
Vedi anche
Document . RemoveMacros ()
HasRevisions
Ritorna ‘verità’ se il documento ha eventuali modifiche tracciate.
public bool HasRevisions { get; }
Valore di proprietà
Remarks
Questa proprietà è una breve per confrontare Aspose.Words.RevisionCollection.Count a zero.
HyphenationOptions
Fornisce l’accesso alle opzioni di hyphenation dei documenti.
public HyphenationOptions HyphenationOptions { get; }
Valore di proprietà
IncludeTextboxesFootnotesEndnotesInStat
Specifica se includere scatole di testo, note e endnotes nelle statistiche di conteggio di parole.
public bool IncludeTextboxesFootnotesEndnotesInStat { get; set; }
Valore di proprietà
JustificationMode
Riceve o impone l’adeguamento dello spazio del carattere di un documento.
public JustificationMode JustificationMode { get; set; }
Valore di proprietà
LastSection
Ricevi l’ultima sezione del documento.
public Section LastSection { get; }
Valore di proprietà
Remarks
Ritorna “null” se non ci sono sezioni.
LayoutOptions
Riceve un oggetto Aspose.Words.Layout.LayoutOptions che rappresenta le opzioni per controllare il processo di layout di questo documento.
public LayoutOptions LayoutOptions { get; }
Valore di proprietà
MailMerge
Ritorna un oggetto Aspose.Words.MailMerging.MailMerge che rappresenta la funzione di fusione del messaggio per il documento.
public MailMerge MailMerge { get; }
Valore di proprietà
MailMergeSettings
Riceve o mette l’oggetto che contiene tutte le informazioni di fusione per un documento.
public MailMergeSettings MailMergeSettings { get; set; }
Valore di proprietà
Remarks
È possibile utilizzare questo oggetto per specificare una fonte di dati di fusione di posta per un documento e questa informazione (insieme ai campi di dati disponibili) verrà visualizzata in Microsoft Word quando l’utente apre questo documento.
Questo oggetto non è mai.
NodeType
Ritorno di Aspose.Words.NodeType.Documento.
public override NodeType NodeType { get; }
Valore di proprietà
OriginalFileName
Ricevi il nome del file originale del documento.
public string OriginalFileName { get; }
Valore di proprietà
Remarks
Ritorna se il documento è stato caricato da un flusso o creato vuoto.
OriginalLoadFormat
Riceve il formato del documento originale che è stato caricato in questo oggetto.
public LoadFormat OriginalLoadFormat { get; }
Valore di proprietà
Remarks
Se hai creato un nuovo documento vuoto, restituisce il valore Aspose.Words.LoadFormat.Doc.
PackageCustomParts
Riceve o mette la raccolta di parti personalizzate (contenuto arbitrario) che sono collegate al pacchetto OOXML utilizzando “relazioni sconosciute”.
public CustomPartCollection PackageCustomParts { get; set; }
Valore di proprietà
Remarks
Non confondere queste parti personalizzate con i dati XML personalizzati.Se è necessario accedere alle parti XML personalizzate, utilizzare la proprietà Aspose.Words.Document.CustomXmlParts.
Questa collezione contiene parti OOXML i cui genitori sono il pacchetto OOXML e i loro obiettivi sono di una “relazione sconosciuta”. per ulteriori informazioni vedere Aspose.Words.Markup.CustomPart.
Aspose.Words carica e salva le parti personalizzate solo nei documenti OOXML.
Questa proprietà non può essere.
Aspose.Words.Markup.CustomPart
PageCount
Riceve il numero di pagine nel documento come calcolato dalla più recente operazione di layout della pagina.
public int PageCount { get; }
Valore di proprietà
Vedi anche
Document . UpdatePageLayout ()
ProtectionType
Riceve il tipo di protezione del documento attualmente attivo.
public ProtectionType ProtectionType { get; }
Valore di proprietà
Remarks
Per modificare il tipo di protezione del documento utilizza Aspose.Words.Document.Protect(Aspose.Words.ProtectionType,System.String) e Aspose.Words.Document.Unprotect metodi.
Quando un documento è protetto, l’utente può effettuare solo modifiche limitate, come ad esempio l’aggiunta di annunci, la revisione o la compilazione di un modulo.
Nota che la protezione del documento è diversa dalla protezione della scrittura.La protezione della scrittura è specificata utilizzando Aspose.Words.Document.WriteProtection
Aspose.Words.Document.Protect(Aspose.Words.ProtectionType,System.String) Aspose.Words.Document.Unprotect Aspose.Words.Document.WriteProtection
PunctuationKerning
Determinerà se l’argomento si applica sia al testo latino che alla punctuazione.
public bool PunctuationKerning { get; set; }
Valore di proprietà
RemovePersonalInformation
Riceve o mette una bandiera indicando che Microsoft Word rimuoverà tutte le informazioni utente dai commenti, revisioni eProprietà del documento al momento della conservazione del documento.
public bool RemovePersonalInformation { get; set; }
Valore di proprietà
Revisions
Riceve una raccolta di revisioni (modifica tracciata) che esistono in questo documento.
public RevisionCollection Revisions { get; }
Valore di proprietà
Remarks
La raccolta restituita è una raccolta “live”, il che significa che se rimuovi parti di un documento che contiene revisioni, le revisioni cancellate scompariranno automaticamente da questa raccolta.
RevisionsView
Riceve o impone un valore che indica se lavorare con la versione originale o rivista di un documento.
public RevisionsView RevisionsView { get; set; }
Valore di proprietà
Remarks
Il valore default è Sito ufficiale.Words.RevisionsView.Original.
Sections
Ritorna una raccolta che rappresenta tutte le sezioni del documento.
public SectionCollection Sections { get; }
Valore di proprietà
ShadeFormData
Determinare se rivolgersi alla ombra grigia sui campi di forma.
public bool ShadeFormData { get; set; }
Valore di proprietà
ShowGrammaticalErrors
Indica se visualizzare errori di grammatica in questo documento.
public bool ShowGrammaticalErrors { get; set; }
Valore di proprietà
ShowSpellingErrors
Determinare se visualizzare errori di riproduzione in questo documento.
public bool ShowSpellingErrors { get; set; }
Valore di proprietà
SpellingChecked
Ritorna ‘verità’ se il documento è stato controllato per la riproduzione.
public bool SpellingChecked { get; set; }
Valore di proprietà
Remarks
Per riconquistare la scrittura nel documento, impostare questa proprietà a “falso”.
Theme
Ricevi l’oggetto Aspose.Words.Document.Theme per questo documento.
public Theme Theme { get; }
Valore di proprietà
TrackRevisions
È vero se i cambiamenti vengono tracciati quando questo documento viene modificato in Microsoft Word.
public bool TrackRevisions { get; set; }
Valore di proprietà
Remarks
Impostazione di questa opzione indica solo a Microsoft Word se i cambiamenti di traccia sono aperti o disattivati.Questa proprietà non ha alcun effetto sui cambiamenti al documento che fai programmaticamente tramite Aspose.Words.
Se si desidera tracciare automaticamente i cambiamenti come sono fatti programmaticamente da Aspose.Words a questo documento utilizza il metodo Aspose.Words.Document.StartTrackRevisions(System.String,System.DateTime).
Variables
Ritorna la raccolta di variabili aggiunte a un documento o modello.
public VariableCollection Variables { get; }
Valore di proprietà
VbaProject
Ottieni o impostare un Aspose.Words.Document.VbaProject.
public VbaProject VbaProject { get; set; }
Valore di proprietà
VersionsCount
Riceve il numero di versioni del documento che sono state memorizzate nel documento DOC.
public int VersionsCount { get; }
Valore di proprietà
Remarks
Le versioni di Microsoft Word sono accessibili tramite il menu File/Versioni. Microsoft Word supporta le versioni solo per i file DOC.
Questa proprietà consente di rilevare se c’erano versioni di documento memorizzate in questo documento prima di essere aperto in Aspose.Words. Aspose.Words non fornisce altro supporto per le versioni di documento. Se si salva questo documento utilizzando Aspose.Words, il documento sarà salvato senza versioni.
ViewOptions
Offre opzioni per controllare come il documento viene visualizzato in Microsoft Word.
public ViewOptions ViewOptions { get; }
Valore di proprietà
Watermark
Fornisce accesso al documento watermark.
public Watermark Watermark { get; }
Valore di proprietà
WebExtensionTaskPanes
Ritorna una raccolta che rappresenta un elenco di Task Pan add-ins.
public TaskPaneCollection WebExtensionTaskPanes { get; }
Valore di proprietà
WriteProtection
Fornisce l’accesso al documento scrivere opzioni di protezione.
public WriteProtection WriteProtection { get; }
Valore di proprietà
Methods
Accept(DocumentVisitor)
Accetta un visitatore.
public override bool Accept(DocumentVisitor visitor)
Parameters
visitor
DocumentVisitor
Il visitatore che visiterà i nodi.
Returns
È vero se tutti i nodi sono stati visitati; falso se Aspose.Words.DocumentVisitor ha interrotto l’operazione prima di visitare tutti i nodi.
Remarks
Elenco su questo nodo e tutti i suoi figli. Ogni nodo chiama un metodo corrispondente su Aspose.Words.DocumentVisitor.
Per ulteriori informazioni vedere il modello di design Visitor.
AcceptAllRevisions()
Accetta tutte le modifiche tracciate nel documento.
public void AcceptAllRevisions()
Remarks
Questo metodo è un shortcut per Aspose.Words.RevisionCollection.AcceptAll.
AcceptEnd(DocumentVisitor)
Accetta un visitatore per visitare la fine del documento.
public override VisitorAction AcceptEnd(DocumentVisitor visitor)
Parameters
visitor
DocumentVisitor
Il visitatore del documento.
Returns
Le azioni da intraprendere dal visitatore.
AcceptStart(DocumentVisitor)
Accetta un visitatore per visitare l’inizio del documento.
public override VisitorAction AcceptStart(DocumentVisitor visitor)
Parameters
visitor
DocumentVisitor
Il visitatore del documento.
Returns
Le azioni da intraprendere dal visitatore.
AppendDocument(Documento, ImportFormatMode)
Aggiungi il documento specificato alla fine di questo documento.
public void AppendDocument(Document srcDoc, ImportFormatMode importFormatMode)
Parameters
srcDoc
Document
Il documento da appendere.
importFormatMode
ImportFormatMode
Specifica come combinare lo stile di formattamento che colpisce.
AppendDocument(Documento, ImportFormatMode, ImportFormatOptions)
Aggiungi il documento specificato alla fine di questo documento.
public void AppendDocument(Document srcDoc, ImportFormatMode importFormatMode, ImportFormatOptions importFormatOptions)
Parameters
srcDoc
Document
Il documento da appendere.
importFormatMode
ImportFormatMode
Specifica come combinare lo stile di formattamento che colpisce.
importFormatOptions
ImportFormatOptions
Permette di specificare le opzioni che influenzano la formattazione di un documento di risultato.
Cleanup()
Pulire gli stili e le elenchi non utilizzati dal documento.
public void Cleanup()
Cleanup(CleanupOptions)
Pulisce gli stili e le elenchi non utilizzati dal documento a seconda di Aspose.Words.CleanupOptions.
public void Cleanup(CleanupOptions options)
Parameters
options
CleanupOptions
Clone()
Realizza una copia profonda del Aspose.Words.Document.
public Document Clone()
Returns
Il documento clonato.
Compare(Documento, string, dateTime)
Confronta questo documento con un altro documento che produce modifiche come il numero di revisioni di editing e formato Aspose.Words.Revision.
public void Compare(Document document, string author, DateTime dateTime)
Parameters
document
Document
Documenti da confrontare.
author
string
Iniziali dell’autore da utilizzare per le revisioni.
dateTime
DateTime
Data e ora di utilizzo per le revisioni.
Remarks
I documenti non devono avere revisioni prima della confrontazione.
Compare(Documento, string, DateTime, CompareOptions)
Confronta questo documento con un altro documento che produce modifiche come un numero di revisioni di modifica e formato Aspose.Words.Revision.Consente di specificare le opzioni di confronto utilizzando Aspose.Words.Comparing.CompareOptions.
public void Compare(Document document, string author, DateTime dateTime, CompareOptions options)
Parameters
document
Document
author
string
dateTime
DateTime
options
CompareOptions
CopyStylesFromTemplate(String)
Copia gli stili dal modello specificato a un documento.
public void CopyStylesFromTemplate(string template)
Parameters
template
string
Remarks
Quando gli stili vengono copiati da un modello a un documento,Stili di nome simile nel documento sono redefiniti per corrispondere alle descrizioni dello stile nel modello.Stili unici dal modello vengono copiati al documento. Stili unici nel documento rimangono intatti.
CopyStylesFromTemplate(Document)
Copia gli stili dal modello specificato a un documento.
public void CopyStylesFromTemplate(Document template)
Parameters
template
Document
Remarks
Quando gli stili vengono copiati da un modello a un documento,Stili di nome simile nel documento sono redefiniti per corrispondere alle descrizioni dello stile nel modello.Stili unici dal modello vengono copiati al documento. Stili unici nel documento rimangono intatti.
EnsureMinimum()
Se il documento non contiene sezioni, crea una sezione con un paragrafo.
public void EnsureMinimum()
ExpandTableStylesToDirectFormatting()
Convertire la formattazione specificata in stili di tabella in formattazione diretta su tabelle nel documento.
public void ExpandTableStylesToDirectFormatting()
Remarks
Questo metodo esiste perché questa versione di Aspose.Words fornisce solo supporto limitato per gli stili di tabella (vedere qui sotto). Questo metodo potrebbe essere utile quando si carica un documento DOCX o WordprocessingML che contiene tabelle formattate con stili di tabella e si deve chiedere la formattazione di tabelle, celle, paragrafi o testo.
Questa versione di Aspose.Words fornisce supporto limitato per gli stili di tavola come segue:
- Gli stili di tabella definiti nei documenti DOCX o WordprocessingML vengono conservati come stili di tabella quando il documento viene salvato come DOCX o WordprocessingML.
- Gli stili di tabella definiti nei documenti DOCX o WordprocessingML vengono automaticamente convertiti in formato diretto su tabelle quando il documento viene salvato in qualsiasi altro formato, rendering o stampa.
- Gli stili di tabella definiti nei documenti DOC vengono conservati come stili di tabella quando il documento viene salvato solo come DOC.
ExtractPages(di int, int)
Ritorna l’oggetto Aspose.Words.Document che rappresenta una specifica gamma di pagine.
public Document ExtractPages(int index, int count)
Parameters
index
int
L’indice basato su zero della prima pagina da estrarre.
count
int
Numero di pagine da estrarre.
Returns
Remarks
Il documento risultante dovrebbe sembrare quello in MS Word, come se avessimo eseguito ‘Imprima pagine specifiche’ - il numero,Il layout dei capolavori/piedi e delle tavole crociali sarà conservato.Ma a causa di un gran numero di nuanze, che appaiono mentre riducono il numero di pagine, la corrispondenza completa del layout è un compito tranquillo e complicato che richiede un sacco di sforzo.A seconda della complessità del documento potrebbero esserci piccole differenze nel layout dei contenuti del documento risultante rispetto al documento sorgente.Qualsiasi feedback sarebbe molto apprezzato.
GetPageInfo(int)
Riceve la dimensione della pagina, l’orientamento e altre informazioni su una pagina che potrebbe essere utile per la stampa o il rendering.
public PageInfo GetPageInfo(int pageIndex)
Parameters
pageIndex
int
L’indice di pagina basato su 0.
Returns
JoinRunsWithSameFormatting()
Partecipa a corse con lo stesso formato in tutti i paragrafi del documento.
public int JoinRunsWithSameFormatting()
Returns
Numero di appuntamenti effettuati. quando N I corsi adiacenti si aggiungono che contano come N - 1 si unisce.
Remarks
Questo è un metodo di ottimizzazione. Alcuni documenti contengono corse adiacenti con lo stesso formato. Di solito questo accade se un documento è stato intensamente modificato manualmente. Puoi ridurre la dimensione del documento e accelerare ulteriormente il trattamento aggiungendo questi corsi.
L’operazione verifica ogni nodo Aspose.Words.Paragraph nel documento per i nodo Aspose.Words.Run adiacenti che hanno proprietà identiche. Ignorano gli identificatori unici utilizzati per tracciare le sessioni di modifica della creazione e della modifica di esecuzione. La prima esecuzione in ogni sequenza adesiva accumula tutto il testo. Le rimanenti esecuzioni vengono cancellate dal documento.
NormalizeFieldTypes()
Modifica i valori del tipo di campo Aspose.Words.Fields.FieldChar.FieldType di Aspose.Words.Fields.FieldStart, Aspose.Words.Fields.FieldSeparator, Aspose.Words.Fields.FieldEndin tutto il documento in modo che corrispondano ai tipi di campo contenuti nei codici di campo.
public void NormalizeFieldTypes()
Remarks
Utilizzare questo metodo dopo i cambiamenti del documento che influenzano i tipi di campo.
Per modificare i valori del tipo di campo in una parte specifica del documento, utilizzare Aspose.Words.Range.NormalizeFieldTypes.
Protect(ProtectionType)
Proteggere il documento dai cambiamenti senza cambiare la password esistente o assegnare una password casuale.
public void Protect(ProtectionType type)
Parameters
type
ProtectionType
Determinare il tipo di protezione del documento.
Remarks
Quando un documento è protetto, l’utente può effettuare solo modifiche limitate, come ad esempio l’aggiunta di annunci, la revisione o la compilazione di un modulo.
Quando si protegge un documento e il documento ha già una password di protezione, la password di protezione esistente non viene modificata.
Quando si protegge un documento e il documento non ha una password di protezione, questo metodo assegna una password casuale che rende impossibile non proteggere il documento in Microsoft Word, ma è ancora possibile non proteggere il documento in Aspose.Words poiché non richiede una password quando non protegge.
Protect(Protezione, String)
Proteggere il documento dai cambiamenti e impone opzionale una password di protezione.
public void Protect(ProtectionType type, string password)
Parameters
type
ProtectionType
Determinare il tipo di protezione del documento.
password
string
La password per proteggere il documento con.Specifica ‘zero’ o ramo vuoto se si desidera proteggere il documento senza una password.
Remarks
Quando un documento è protetto, l’utente può effettuare solo modifiche limitate, come ad esempio l’aggiunta di annunci, la revisione o la compilazione di un modulo.
Nota che la protezione del documento è diversa dalla protezione della scrittura.La protezione della scrittura è specificata utilizzando Aspose.Words.Document.WriteProtection.
RemoveBlankPages()
Rimuove le pagine bianche dal documento.
public List<int> RemoveBlankPages()
Returns
L’elenco dei numeri di pagina è stato considerato bianco e rimosso.
Remarks
Il documento risultante non contiene pagine considerate di essere bianche mentre altri contenuti,compresi i numeri, i headers/footers e il layout generale dovrebbero rimanere invariati.
La pagina è considerata bianca quando il corpo della pagina non ha contenuti visibili, ad esempio:La tabella vuota senza confini sarà considerata invisibile e quindi la pagina sarà rilevata come bianca.
RemoveExternalSchemaReferences()
Rimuove i riferimenti di schema XML esterni da questo documento.
public void RemoveExternalSchemaReferences()
RemoveMacros()
Rimuove tutti i macro (il progetto VBA) nonché le barre di strumenti e le personalizzazioni di comando dal documento.
public void RemoveMacros()
Remarks
Rimuovendo tutti i macro da un documento è possibile assicurarsi che il documento non contiene macro virus.
RenderToScale(Integrazione, SKCanvas, float, float, float)
[CLSCompliant(false)]
public SizeF RenderToScale(int pageIndex, SKCanvas graphics, float x, float y, float scale)
Parameters
pageIndex
int
graphics
Cancellato
x
float
y
float
scale
float
Returns
RenderToSize(Integrazione, SKCanvas, float, float, float, float)
[CLSCompliant(false)]
public float RenderToSize(int pageIndex, SKCanvas graphics, float x, float y, float width, float height)
Parameters
pageIndex
int
graphics
Cancellato
x
float
y
float
width
float
height
float
Returns
Save(String)
Salva il documento in un file. determina automaticamente il formato di salvataggio dall’estensione.
public SaveOutputParameters Save(string fileName)
Parameters
fileName
string
Il nome del documento. se un documento con ilIl nome del file specificato è già presente, il documento esistente è soppreso.
Returns
Informazioni aggiuntive che puoi utilizzare opzionalmente.
Save(Riflessioni, SaveFormat)
Salva il documento in un file nel formato specificato.
public SaveOutputParameters Save(string fileName, SaveFormat saveFormat)
Parameters
fileName
string
Il nome del documento. se un documento con ilIl nome del file specificato è già presente, il documento esistente è soppreso.
saveFormat
SaveFormat
Il formato in cui salvare il documento.
Returns
Informazioni aggiuntive che puoi utilizzare opzionalmente.
Save(String, opzioni di salvataggio)
Salva il documento in un file utilizzando le opzioni di salvataggio specificate.
public SaveOutputParameters Save(string fileName, SaveOptions saveOptions)
Parameters
fileName
string
Il nome del documento. se un documento con ilIl nome del file specificato è già presente, il documento esistente è soppreso.
saveOptions
SaveOptions
Specifica le opzioni che controllano come il documento viene salvato. può essere ‘zero’.
Returns
Informazioni aggiuntive che puoi utilizzare opzionalmente.
Save(Sviluppo, SaveFormat)
Salva il documento in un flusso utilizzando il formato specificato.
public SaveOutputParameters Save(Stream stream, SaveFormat saveFormat)
Parameters
stream
Stream
Scopri dove salvare il documento.
saveFormat
SaveFormat
Il formato in cui salvare il documento.
Returns
Informazioni aggiuntive che puoi utilizzare opzionalmente.
Save(Sviluppo, SaveOptions)
Salva il documento in un flusso utilizzando le opzioni di salvataggio specificate.
public SaveOutputParameters Save(Stream stream, SaveOptions saveOptions)
Parameters
stream
Stream
Scopri dove salvare il documento.
saveOptions
SaveOptions
Specifica le opzioni che controllano come il documento viene salvato. Può essere ‘zero’.Se questo è ‘zero’, il documento sarà salvato nel formato DOC binario.
Returns
Informazioni aggiuntive che puoi utilizzare opzionalmente.
StartTrackRevisions(String e DateTime)
Inizia automaticamente a segnalare tutti i ulteriori cambiamenti che fai al documento in modo programmatico come cambiamenti di revisione.
public void StartTrackRevisions(string author, DateTime dateTime)
Parameters
author
string
Iniziali dell’autore da utilizzare per le revisioni.
dateTime
DateTime
Data e ora di utilizzo per le revisioni.
Remarks
Se chiamate questo metodo e poi fate alcuni cambiamenti al documento programmaticamente, salvare il documento e poi aprire il documento in MS Word vedrete questi cambiamenti come revisioni.
Attualmente Aspose.Words supporta solo il monitoraggio delle inserzioni e dei cancellamenti dei nodi.
Il monitoraggio automatico dei cambiamenti è supportato sia quando si modifica questo documento attraverso le manipolazioni dei nodi che quando si utilizza Aspose.Words.DocumentBuilder
Questo metodo non cambia l’opzione Aspose.Words.Document.TrackRevisions e non utilizza il suo valore per le finalità di revisione di tracciamento.
Vedi anche
Document . StopTrackRevisions ()
StartTrackRevisions(String)
Inizia automaticamente a segnalare tutti i ulteriori cambiamenti che fai al documento in modo programmatico come cambiamenti di revisione.
public void StartTrackRevisions(string author)
Parameters
author
string
Iniziali dell’autore da utilizzare per le revisioni.
Remarks
Se chiamate questo metodo e poi fate alcuni cambiamenti al documento programmaticamente, salvare il documento e poi aprire il documento in MS Word vedrete questi cambiamenti come revisioni.
Attualmente Aspose.Words supporta solo il monitoraggio delle inserzioni e dei cancellamenti dei nodi.
Il monitoraggio automatico dei cambiamenti è supportato sia quando si modifica questo documento attraverso le manipolazioni dei nodi che quando si utilizza Aspose.Words.DocumentBuilder
Questo metodo non cambia l’opzione Aspose.Words.Document.TrackRevisions e non utilizza il suo valore per le finalità di revisione di tracciamento.
Vedi anche
Document . StopTrackRevisions ()
StopTrackRevisions()
Ferma la marcatura automatica dei documenti come modifiche.
public void StopTrackRevisions()
Vedi anche
Document . StartTrackRevisions ( string , DateTime )
UnlinkFields()
Desconnessione dei campi in tutto il documento.
public void UnlinkFields()
Remarks
Sostituisce tutti i campi dell’intero documento con i loro risultati più recenti.
Per disconnettere i campi in una parte specifica del documento, utilizzare Aspose.Words.Range.UnlinkFields.
Unprotect()
Rimuove la protezione dal documento indipendentemente dalla password.
public void Unprotect()
Remarks
Questo metodo non protegge il documento anche se ha una password di protezione.
Nota che la protezione del documento è diversa dalla protezione della scrittura.La protezione della scrittura è specificata utilizzando Aspose.Words.Document.WriteProtection.
Unprotect(String)
Rimuove la protezione dal documento se viene specificata una password corretta.
public bool Unprotect(string password)
Parameters
password
string
La password per non proteggere il documento con.
Returns
“Vero” se è stata specificata una password corretta e il documento non è stato protetto.
Remarks
Questo metodo non protegge il documento solo se è specificata una password corretta.
Nota che la protezione del documento è diversa dalla protezione della scrittura.La protezione della scrittura è specificata utilizzando Aspose.Words.Document.WriteProtection.
UpdateActualReferenceMarks()
Aggiornare la proprietà di Aspose.Words.Notes.Footnote.ActualReferenceMark di tutte le note e gli endnotes nel documento.
public void UpdateActualReferenceMarks()
Remarks
I campi di aggiornamento (Aspose.Words.Document.UpdateFields) possono essere necessari per ottenere il risultato corretto.
UpdateFields()
Aggiornare i valori dei campi in tutto il documento.
public void UpdateFields()
Remarks
<p>When you open, modify and then save a document, Aspose.Words does not update fields automatically, it keeps them intact.
Pertanto, di solito vorresti chiamare questo metodo prima di salvare se hai modificato il documentoprogrammaticamente e vogliono assicurarsi che i valori di campo corretti (calcolati) vengano visualizzati nel documento salvato.
Non c’è bisogno di aggiornare i campi dopo l’esecuzione di una fusione di posta perché la fusione di posta è una sorta di aggiornamento dei campi e aggiornare automaticamente tutti i campi nel documento.
Questo metodo non aggiornano tutti i tipi di campi. Per l’elenco dettagliato dei tipi di campi supportati, vedere la Guida dei Programmatori.
Questo metodo non aggiornano i campi che sono correlati agli algoritmi di layout della pagina (ad esempio PAGE, PAGES, PAGEREF). I campi correlati alla layout della pagina vengono aggiornati quando si renderà un documento o si chiama Aspose.Words.Document.UpdatePageLayout.
Utilizzare il metodo Aspose.Words.Document.NormalizeFieldTypes prima di aggiornare i campi se ci sono cambiamenti di documento che hanno colpito i tipi di campi.
Per aggiornare i campi in una parte specifica del documento, utilizzare Aspose.Words.Range.UpdateFields.
UpdateListLabels()
Aggiornare le etichette della lista per tutti gli elementi della lista nel documento.
public void UpdateListLabels()
Remarks
Questo metodo aggiorna le proprietà di etichetta come Aspose.Words.Lists.ListLabel.LabelValue e Aspose.Words.Lists.ListLabel.LabelString per ogni oggetto Aspose.Words.Paragraph.ListLabel nel documento.
Questo è necessario perché alcuni campi che possono fare riferimento ai numeri di elenco (come TOC o REF) hanno bisogno di essere aggiornati.
UpdatePageLayout()
Ripristina il layout della pagina del documento.
public void UpdatePageLayout()
Remarks
Questo metodo formatta un documento in pagine e aggiornano i campi relativi al numero di pagina nel documento come PAGE, PAGES, PAGEREF e REF. Le informazioni di layout della pagina aggiornate sono necessarie per una corretta trasmissione del documento in formati di pagina fissa.
Questo metodo viene automaticamente invocato quando prima si converte un documento in PDF, XPS, immagine o stamparlo. tuttavia, se si modifica il documento dopo il rendering e poi cercare di renderlo nuovamente - Aspose.Words non aggiornerà automaticamente il layout della pagina. In questo caso si dovrebbe chiamare Aspose.Words.Document.UpdatePageLayout prima di rendering nuovamente.
UpdateTableLayout()
Implementa un approccio precedente alla larghezza della colonna di tabella di ri-calcolo che ha conosciuto problemi.
[Obsolete("Obsolete, column widths are re-calculated automatically before saving.")]
public void UpdateTableLayout()
Remarks
Il metodo è deprezzato e sarà rimosso in pochi rilasciamenti.
UpdateThumbnail(ThumbnailGeneratingOptions)
Aggiornamenti Aspose.Words.Properties.BuiltInDocumentProperties.Thumbnail del documento secondo le opzioni specificate.
public void UpdateThumbnail(ThumbnailGeneratingOptions options)
Parameters
options
ThumbnailGeneratingOptions
Le opzioni generative da utilizzare.
Remarks
Il Aspose.Words.Rendering.ThumbnailGeneratingOptions consente di specificare la fonte di miniatura, dimensioni e altre opzioni.Se il tentativo di generare un minimo fallisce, non cambia uno.
UpdateThumbnail()
Aggiornare Aspose.Words.Properties.BuiltInDocumentProperties.Thumbnail del documento utilizzando le opzioni predefinite.
public void UpdateThumbnail()
UpdateWordCount()
Aggiornare il termine conta le proprietà del documento.
public void UpdateWordCount()
Remarks
Aspose.Words.Document.UpdateWordCount ricalculano e aggiornano le proprietà dei Caratteri, delle Parole e dei Paragli nella raccolta di Proprietà dei Wl26.
Si prega di notare che Aspose.Words.Document.UpdateWordCount non aggiornare il numero di righe e proprietà di pagine. Utilizzare Aspose.Words.Document.UpdateWordCount sovraccarica e passare il valore come parametro per farlo.
Quando si utilizza una versione di valutazione, il marchio di valutazione sarà incluso anche nel numero di parole.
UpdateWordCount(di bool)
Aggiornare le proprietà del documento, aggiornare opzionalmente Aspose.Words.Properties.BuiltInDocumentProperties.Lines proprietà.
public void UpdateWordCount(bool updateLinesCount)
Parameters
updateLinesCount
bool
‘verità’ se si calcola il numero di righe nel documento.
Remarks
Questo metodo ristrutturerà il layout della pagina del documento.