Class Document

Class Document

名称: Aspose.Words 集合: Aspose.Words.dll (25.4.0)

代表一个Word文件。

要了解更多,请参观 Working with Document 文档文章。

public class Document : DocumentBase, IEnumerable<node>, IEnumerable, IXPathNavigable

Inheritance

object Node CompositeNode DocumentBase Document

Implements

IEnumerable , IEnumerable ,9 可行

继承人

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Remarks

Aspose.Words.Document 是 Aspose.Words 图书馆的一个中心对象。

要在任何 Aspose.Words.LoadFormat 格式中加载现有文档,请将文件名或流输入其中一个 Aspose.Words.Document constructors。

使用存储方法中的一个存储文件在任何 Aspose.Words.SaveFormat 格式。

要直接在对象上绘制文档页面,使用 Aspose.Words.Document.RenderToScale(System.Int32,System.Drawing.Graphics,System.Single,System.Single,System.Single)或 Aspose.Words.Document.RenderToSize(System.Int32,System.Drawing.Graphics,System.Single,System.Single,System.Single,System.Single)方法。

要打印文件,请使用 Aspose.Words.Document.Print(System.String) 方法之一。

WL26_.Document.MailMerge 是 _Wl26 的报告引擎,允许在 Microsoft Word 中快速和轻松地将来自不同数据来源的数据编辑报告。数据可以来自 DataSet、DataTable、dataView、IDataReader 或一系列值。

Aspose.Words.Document 存储多文档的信息,如 Wl26 .DokumentBase.Styles, _ WL26.DOCument.BuiltInDicumentProperties、 _ www.wl27.document .CustomDock 属性、列表和宏。

Aspose.Words.Document 是一棵树的根节点,包含文档的所有其他节点. 树是复合设计模式,并以许多方式类似于 XmlDocument. 文档的内容可以自由编程:

  • 文档的节点可以通过编写的集合访问,例如 Aspose.Words.Document.Sections, Aspose.Words.ParagraphCollection 等。
  • 文档的节点可以根据其节点类型选择,使用 Aspose.Words.CompositeNode.GetChildNodes(Aspose.Words.NodeType,System.Boolean)或使用 XPath 查询与 Aspose.Words.CompositeNode.SelectNodes(System.String)或 Aspose.Words.CompositeNode.SelectSingleNode(System.String)。
  • 内容节点可以在文档中的任何地方添加或删除,使用 Aspose.Words.CompositeNode.InsertBefore(“1”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0”,“0
  • 每个节点的格式化属性可以通过该节点的属性进行更改。

考虑使用 Aspose.Words.DocumentBuilder 来简化编程创建或人口化文档树的任务。

Aspose.Words.Document 只能包含 Aspose.Words.Section 对象。

在 Microsoft Word 中,有效文件必须至少包含一个部分。

Constructors

Document()

创建一个白色Word文档。

public Document()

Remarks

一个空白文档从资源中获取,并且默认情况下,结果文档看起来更像是由Aspose.Words.Settings.MsWordVersion.Word2007创建的。

Aspose.Words.Settings.CompatibilityOptions.OptimizeFor(W L 26.MsWordVersion)方法可以用来优化文档内容以及默认的 __ WL 26_ 行为到一个特定的版本的 MS Word。

文档纸大小是默认字母. 如果您想更改页面设置,请使用 Aspose.Words.Section.PageSetup。

创建后,您可以使用 Aspose.Words.DocumentBuilder 轻松添加文档内容。

Document(线条)

从文件中打开现有文件,自动检测到文件格式。

public Document(string fileName)

Parameters

fileName string

文件名称要打开。

Exceptions

UnsupportedFileFormatException

文件格式不被认可或支持。

FileCorruptedException

文件似乎是腐败的,不能被加载。

Exception

有一个问题与文档,它应该报告到Aspose.Words开发人员。

IOException

有一个输入/输出例外。

IncorrectPasswordException

文件是加密的,需要一个密码来打开,但您提供了一个错误的密码。

ArgumentException

文件的名称不能是零或空字符串。

Document(字符串, LoadOptions)

从文件中打开现有文档 允许指定额外的选项,如加密密码。

public Document(string fileName, LoadOptions loadOptions)

Parameters

fileName string

文件名称要打开。

loadOptions LoadOptions

在下载文档时使用的额外选项可以是“零”。

Exceptions

UnsupportedFileFormatException

文件格式不被认可或支持。

FileCorruptedException

文件似乎是腐败的,不能被加载。

Exception

有一个问题与文档,它应该报告到Aspose.Words开发人员。

IOException

有一个输入/输出例外。

IncorrectPasswordException

文件是加密的,需要一个密码来打开,但您提供了一个错误的密码。

ArgumentException

文件的名称不能是零或空字符串。

Document(Stream)

从流中打开现有文档,自动检测文件格式。

public Document(Stream stream)

Parameters

stream Stream

流到哪里可以上传文件。

Remarks

文件必须在流的开始时存储,流必须支持随机定位。

Exceptions

UnsupportedFileFormatException

文件格式不被认可或支持。

FileCorruptedException

文件似乎是腐败的,不能被加载。

Exception

有一个问题与文档,它应该报告到Aspose.Words开发人员。

IOException

有一个输入/输出例外。

IncorrectPasswordException

文件是加密的,需要一个密码来打开,但您提供了一个错误的密码。

ArgumentNullException

流量不能是零。

NotSupportedException

流量不支持阅读或搜索。

ObjectDisposedException

流是废弃的对象。

Document(流量, LoadOptions)

从流中打开现有文档 允许指定额外的选项,如加密密码。

public Document(Stream stream, LoadOptions loadOptions)

Parameters

stream Stream

流程从哪里上传文件。

loadOptions LoadOptions

在下载文档时使用的额外选项可以是“零”。

Remarks

文件必须在流的开始时存储,流必须支持随机定位。

Exceptions

UnsupportedFileFormatException

文件格式不被认可或支持。

FileCorruptedException

文件似乎是腐败的,不能被加载。

Exception

有一个问题与文档,它应该报告到Aspose.Words开发人员。

IOException

有一个输入/输出例外。

IncorrectPasswordException

文件是加密的,需要一个密码来打开,但您提供了一个错误的密码。

ArgumentNullException

流量不能是零。

NotSupportedException

流量不支持阅读或搜索。

ObjectDisposedException

流是废弃的对象。

Properties

AttachedTemplate

接收或设置文件附带的模板的完整路径。

public string AttachedTemplate { get; set; }

财产价值

string

Remarks

空线意味着文件附加到正常模板。

Aspose.Words.Properties.BuiltInDocumentProperties.模板

Exceptions

ArgumentNullException

如果你试图设置到“零”值。

AutomaticallyUpdateStyles

收到或设置一个标志表明文件中的风格是否更新,以匹配文件中的风格。附加模板每次文件在 MS Word 中打开时。

public bool AutomaticallyUpdateStyles { get; set; }

财产价值

bool

Bibliography

获取 Aspose.Words.Document.Bibliography 对象,代表文档中可用的来源列表。

public Bibliography Bibliography { get; }

财产价值

Bibliography

BuiltInDocumentProperties

返回一份代表文件中的所有内置文件属性的集合。

public BuiltInDocumentProperties BuiltInDocumentProperties { get; }

财产价值

BuiltInDocumentProperties

CompatibilityOptions

提供访问文档兼容性选项(即输入的用户偏好) Compatibility标签TAB Options 对话在词语中。

public CompatibilityOptions CompatibilityOptions { get; }

财产价值

CompatibilityOptions

Compliance

收到 OOXML 遵守版本,从加载文档内容中确定。它只适用于OOXML文件。

public OoxmlCompliance Compliance { get; }

财产价值

OoxmlCompliance

Remarks

如果您创建了一个新的空白文件或加载非OOXML文件,则将返回 Aspose.Words.Saving.OoxmlCompliance.Ecma376_2006 值。

CustomDocumentProperties

返回一份代表文档的所有自定义文档属性的集合。

public CustomDocumentProperties CustomDocumentProperties { get; }

财产价值

CustomDocumentProperties

CustomXmlParts

获取或设置自定义 XML 数据存储部分的收藏。

public CustomXmlPartCollection CustomXmlParts { get; set; }

财产价值

CustomXmlPartCollection

Remarks

Aspose.Words 只在 OOXML 和 DOC 文档中加载和保存自定义 XML 部分。

这个财产不能。

ASPOSE.Words.Markup.CustomXml部分

DefaultTabStop

接收或设置默认选项卡停止之间的间隔(点)。

public double DefaultTabStop { get; set; }

财产价值

double

看也

TabStopCollection , TabStop

DigitalSignatures

收到本文的数字签名收集及其验证结果。

public DigitalSignatureCollection DigitalSignatures { get; }

财产价值

DigitalSignatureCollection

Remarks

这些数字签名不会保存,当您将此 Aspose.Words.Document 对象保存到文件或流,因为保存或转换将产生与原始不同的文件,而原始数字签名将不再有效。

如果文件没有签名,它将包含零元素。

EndnoteOptions

提供控制本文中的终端笔记的编号和定位的选项。

public EndnoteOptions EndnoteOptions { get; }

财产价值

EndnoteOptions

FieldOptions

得到一个 Aspose.Words.Fields.FieldOptions 对象,代表控制文件中的字段处理的选项。

public FieldOptions FieldOptions { get; }

财产价值

FieldOptions

FirstSection

收到文档中的第一个部分。

public Section FirstSection { get; }

财产价值

Section

Remarks

返回“零”如果没有部分。

FontSettings

接收或设置文档字体设置。

public FontSettings FontSettings { get; set; }

财产价值

FontSettings

Remarks

此属性允许根据文件指定字体设置. 如果设置为 , 默认静态字体设置 Aspose.Words.Fonts.FontSettings.DefaultInstance 将使用。

默认值是。

FootnoteOptions

提供控制本文中的脚笔数和定位的选项。

public FootnoteOptions FootnoteOptions { get; }

财产价值

FootnoteOptions

Frameset

返回 Aspose.Words.Document.Frameset 示例,如果此文档代表框页面。

public Frameset Frameset { get; }

财产价值

Frameset

Remarks

如果文件没有框架,财产的“零”值。

GlossaryDocument

在此文档或模板中获取或设置语音文件。对于文档中定义的 AutoText、AutoCorrect 和 Building Block 输入。

public GlossaryDocument GlossaryDocument { get; set; }

财产价值

GlossaryDocument

Remarks

此财产将返回,如果文件没有语音文件。

您可以通过创建 Aspose.Words.BuildingBlocks.GlossaryDocument 对象并将其分配到文档中添加一个语音文档。

Aspose.Words.BuildingBlocks.Glossary文档

GrammarChecked

返回“真实”如果文件已被检查为语法。

public bool GrammarChecked { get; set; }

财产价值

bool

Remarks

要将文本中的语法复制,将此属性设置为“虚假”。

HasMacros

返回“真实”如果文件有一个VBA项目(宏)。

public bool HasMacros { get; }

财产价值

bool

看也

Document . RemoveMacros ()

HasRevisions

返回“真实”如果文件有任何跟踪的变化。

public bool HasRevisions { get; }

财产价值

bool

Remarks

此属性是比较 Aspose.Words.RevisionCollection.Count 到零的缩写。

HyphenationOptions

提供文档催眠选项的访问。

public HyphenationOptions HyphenationOptions { get; }

财产价值

HyphenationOptions

IncludeTextboxesFootnotesEndnotesInStat

指定是否在字数统计中包含文本盒、脚笔和终点笔记。

public bool IncludeTextboxesFootnotesEndnotesInStat { get; set; }

财产价值

bool

JustificationMode

收到或设置一个文档的字符空间调整。

public JustificationMode JustificationMode { get; set; }

财产价值

JustificationMode

LastSection

收到文件中的最后一部分。

public Section LastSection { get; }

财产价值

Section

Remarks

返回“零”如果没有部分。

LayoutOptions

收到 Aspose.Words.Layout.LayoutOptions 对象,代表控制该文档的配置过程的选项。

public LayoutOptions LayoutOptions { get; }

财产价值

LayoutOptions

MailMerge

返回 Aspose.Words.MailMerging.MailMerge 对象,代表该文件的邮件合并功能。

public MailMerge MailMerge { get; }

财产价值

MailMerge

MailMergeSettings

收到或设置包含所有邮件合并信息文件的对象。

public MailMergeSettings MailMergeSettings { get; set; }

财产价值

MailMergeSettings

Remarks

您可以使用此对象指定文件的邮件合并数据来源,当用户打开该文件时,将此信息(与可用的数据字段一起)显示在 Microsoft Word. 或者您可以使用此对象查询邮件合并设置,用户在 Microsoft Word 为此文件中指定。

这个对象从来没有。

NodeType

返回 Aspose.Words.NodeType.Document。

public override NodeType NodeType { get; }

财产价值

NodeType

OriginalFileName

获取文件的原始文件名。

public string OriginalFileName { get; }

财产价值

string

Remarks

返回,如果文档从流中加载或创建空白。

OriginalLoadFormat

获取该对象上传的原始文档的格式。

public LoadFormat OriginalLoadFormat { get; }

财产价值

LoadFormat

Remarks

如果您创建了一个新的白色文档,则返回 Aspose.Words.LoadFormat.Doc 值。

PackageCustomParts

通过“未知关系”获取或设置与 OOXML 包链接的自定义部分(自定义内容)的收藏。

public CustomPartCollection PackageCustomParts { get; set; }

财产价值

CustomPartCollection

Remarks

不要将这些自定义部分与自定义 XML 数据混淆. 如果您需要访问自定义 XML 部分,请使用 Aspose.Words.Document.CustomXmlParts 属性。

本集包含 OOXML 部分,其主人是 OOXML 包,其目标是“未知的关系”。 有关更多信息,请参阅 Aspose.Words.Markup.CustomPart。

Aspose.Words 只在 OOXML 文档中加载和保存自定义部分。

这个财产不能。

首頁 〉外文書 〉文學 〉文學 〉Markup.CustomPart

PageCount

收到文件中的页数,根据最新的页面配置操作计算。

public int PageCount { get; }

财产价值

int

看也

Document . UpdatePageLayout ()

ProtectionType

获取目前活跃的文件保护类型。

public ProtectionType ProtectionType { get; }

财产价值

ProtectionType

Remarks

此属性允许恢复目前设置的文档保护类型. 要更改文档保护类型,使用 Aspose.Words.Document.Protect(Aspose.Words.ProtectionType,System.String) 和 Aspose.Words.Document.Unprotect 方法。

当文件受保护时,用户只能进行有限的更改,例如添加笔记、进行审查或填写表格。

请注意,文档保护与写作保护不同. 写作保护是使用 Aspose.Words.Document.WriteProtection 指定

Aspose.Words.Document.Protect(Aspose.Words.ProtectionType,System.String) Aspose.Words.Document.Unprotect Aspose.Words.Document.WriteProtection

PunctuationKerning

它是否适用于拉丁文本和点数。

public bool PunctuationKerning { get; set; }

财产价值

bool

RemovePersonalInformation

收到或设置指示 Microsoft Word 将从评论、审查和保存文件时的文件属性。

public bool RemovePersonalInformation { get; set; }

财产价值

bool

Revisions

收到本文中存在的审查(跟踪变更)的集合。

public RevisionCollection Revisions { get; }

财产价值

RevisionCollection

Remarks

返回收藏是“现场”收藏,即如果您删除包含审查的文件部分,则删除的审查将自动从收藏中消失。

RevisionsView

收到或设置一个值,表明是否与文档的原始或修订版本工作。

public RevisionsView RevisionsView { get; set; }

财产价值

RevisionsView

Remarks

默认值是 首頁 〉外文書 〉文學 〉文學 〉RevisionsView.Original.

Sections

返回一份代表文件中的所有部分的集合。

public SectionCollection Sections { get; }

财产价值

SectionCollection

ShadeFormData

指定是否在形状字段上旋转灰色阴影。

public bool ShadeFormData { get; set; }

财产价值

bool

ShowGrammaticalErrors

说明是否在本文中显示语法错误。

public bool ShowGrammaticalErrors { get; set; }

财产价值

bool

ShowSpellingErrors

指定是否在本文中显示输入错误。

public bool ShowSpellingErrors { get; set; }

财产价值

bool

SpellingChecked

返回“真实”如果文件已被检查。

public bool SpellingChecked { get; set; }

财产价值

bool

Remarks

要在文档中删除字符,将此属性设置为“虚假”。

Theme

获取 Aspose.Words.Document.Theme 对该文件的对象。

public Theme Theme { get; }

财产价值

Theme

TrackRevisions

正确的是,当此文档在Microsoft Word中编辑时,是否会跟踪更改。

public bool TrackRevisions { get; set; }

财产价值

bool

Remarks

设置此选项仅指示 Microsoft Word 是否启动或关闭轨道更改. 此属性不会影响您通过 Aspose.Words 编程进行文档的更改。

如果您想要自动跟踪变更,因为它们是由 Aspose.Words 编程,请使用 Aspose.Words.Document.StartTrackRevisions(System.String,System.DateTime) 方法。

Variables

返回添加到文档或模板的变量集合。

public VariableCollection Variables { get; }

财产价值

VariableCollection

VbaProject

获取或设置 Aspose.Words.Document.VbaProject。

public VbaProject VbaProject { get; set; }

财产价值

VbaProject

VersionsCount

获取在 DOC 文档中存储的文档版本的数量。

public int VersionsCount { get; }

财产价值

int

Remarks

Microsoft Word 版本可通过文件/版本菜单访问,Microsoft Word 仅支持 DOC 文件的版本。

此属性允许检测是否有文档版本存储在本文档之前它在 Aspose.Words 中打开. Aspose.Words 没有其他支持文档版本. 如果您使用 Aspose.Words 保存该文档,文档将存储没有版本。

ViewOptions

提供如何控制文档在 Microsoft Word 中显示的选项。

public ViewOptions ViewOptions { get; }

财产价值

ViewOptions

Watermark

提供文件水标的访问。

public Watermark Watermark { get; }

财产价值

Watermark

WebExtensionTaskPanes

返回代表任务板插件列表的集合。

public TaskPaneCollection WebExtensionTaskPanes { get; }

财产价值

TaskPaneCollection

WriteProtection

提供访问文档写作保护选项。

public WriteProtection WriteProtection { get; }

财产价值

WriteProtection

Methods

Accept(DocumentVisitor)

接受访客。

public override bool Accept(DocumentVisitor visitor)

Parameters

visitor DocumentVisitor

参观者将参观节点。

Returns

bool

如果所有节点都被访问,则是真实的;如果 Aspose.Words.DocumentVisitor在访问所有节点之前停止操作,则是虚假的。

Remarks

列出此节点和其所有儿童。 每个节点在 Aspose.Words.DocumentVisitor 上呼叫相应的方法。

有关更多信息,请参见访问者设计模式。

AcceptAllRevisions()

接受文件中的所有跟踪变更。

public void AcceptAllRevisions()

Remarks

此方法是 Aspose.Words.RevisionCollection.AcceptAll 的简介。

AcceptEnd(DocumentVisitor)

接受访问者访问文档的结尾。

public override VisitorAction AcceptEnd(DocumentVisitor visitor)

Parameters

visitor DocumentVisitor

文件访问者。

Returns

VisitorAction

由参观者采取的行动。

AcceptStart(DocumentVisitor)

接受访问者访问文档的开始。

public override VisitorAction AcceptStart(DocumentVisitor visitor)

Parameters

visitor DocumentVisitor

文件访问者。

Returns

VisitorAction

由参观者采取的行动。

AppendDocument(文件, ImportFormatMode)

将指定的文件添加到本文件的结尾。

public void AppendDocument(Document srcDoc, ImportFormatMode importFormatMode)

Parameters

srcDoc Document

该文件附加。

importFormatMode ImportFormatMode

说明如何合并风格格格式,这些冲突。

AppendDocument(文件, ImportFormatMode, ImportFormatOptions)

将指定的文件添加到本文件的结尾。

public void AppendDocument(Document srcDoc, ImportFormatMode importFormatMode, ImportFormatOptions importFormatOptions)

Parameters

srcDoc Document

该文件附加。

importFormatMode ImportFormatMode

说明如何合并风格格格式,这些冲突。

importFormatOptions ImportFormatOptions

允许指定影响结果文件格式化的选项。

Cleanup()

从文件中清除未使用的风格和列表。

public void Cleanup()

Cleanup(CleanupOptions)

从文件中清除未使用的风格和列表,取决于所提供的 Aspose.Words.CleanupOptions。

public void Cleanup(CleanupOptions options)

Parameters

options CleanupOptions

Clone()

完成 Aspose.Words.Document 的深度副本。

public Document Clone()

Returns

Document

克隆文档。

Compare(文档、字符串、日期)

将此文档与其他文档进行比较,以编辑和格式修订的数量为Aspose.Words.Revision。

public void Compare(Document document, string author, DateTime dateTime)

Parameters

document Document

比较的文件。

author string

作者初步用于审查。

dateTime DateTime

用于审查的日期和时间。

Remarks

注意文件不应在比较之前进行审查。

Compare(文档,字符串, DateTime, 比较选项)

将此文档与另一个文档进行比较,作为一系列编辑和格式修订的Aspose.Words.Revision。允许使用 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(线条)

从指定模板复制风格到文档。

public void CopyStylesFromTemplate(string template)

Parameters

template string

Remarks

当风格从模板复制到文档时,文件中的类似名称的风格重新定义,以匹配模板中的风格描述。模板中的独特风格复制到文档中,文档中的独特风格保持不完整。

CopyStylesFromTemplate(Document)

从指定模板复制风格到文档。

public void CopyStylesFromTemplate(Document template)

Parameters

template Document

Remarks

当风格从模板复制到文档时,文件中的类似名称的风格重新定义,以匹配模板中的风格描述。模板中的独特风格复制到文档中,文档中的独特风格保持不完整。

EnsureMinimum()

如果文件中没有部分,则创建一个部分,其中一个段落。

public void EnsureMinimum()

ExpandTableStylesToDirectFormatting()

将表格风格所规定的格式转换为文档中的表格的直接格式。

public void ExpandTableStylesToDirectFormatting()

Remarks

这个方法存在,因为这个版本的 Aspose.Words 只提供有限的支持表格风格(见下文)。这个方法可能是有用的,当你加载一个 DOCX 或 WordprocessingML 文档,其中包含表格格式与表格式,你需要询问表格格式,细胞,段落或文本。

此版本的 Aspose.Words 提供有限的桌面风格支持如下:

  • 在 DOCX 或 WordprocessingML 文档中定义的桌面风格保存为桌面风格,当文档保存为 DOCX 或 WordprocessingML。
  • 在 DOCX 或 WordprocessingML 文档中定义的表格风格在保存文档时自动转换为直接格式化。
  • 在 DOC 文档中定义的桌面风格仅保存为 DOC 文档时保存为桌面风格。

ExtractPages(int , int , int)

返回 Aspose.Words.Document 对象,代表特定页面范围。

public Document ExtractPages(int index, int count)

Parameters

index int

以零为基础的第一页提取的指数。

count int

要提取的页面数量。

Returns

Document

Remarks

结果文档应该看起来像MS Word中的文档,就好像我们已经完成了“印刷特定的页面” - 编号,头/脚和交叉表的布局将保留。但由于大量的色调,同时减少页数,整个配置的匹配是一个安静复杂的任务,需要大量的努力。根据文档的复杂性,与源文档相比,结果文档内容的布局可能有微小的差异。任何反馈都会受到极大的欣赏。

GetPageInfo(因特)

获取页面大小、方向和有关可能对印刷或播放有用的页面的其他信息。

public PageInfo GetPageInfo(int pageIndex)

Parameters

pageIndex int

基于0的页面指数。

Returns

PageInfo

JoinRunsWithSameFormatting()

加入在文件的所有段落中以相同的格式运行。

public int JoinRunsWithSameFormatting()

Returns

int

加入的数量:当 N 接近的跑步正在加入他们计算为 N - 1 加入。

Remarks

这是一个优化方法. 某些文档包含相同格式的附近行程. 通常情况下,如果文档被精心编辑手动. 您可以通过加入这些行程来减少文档大小并加快进一步处理。

操作检查文件中的每一个 Aspose.Words.Paragraph 节点附近的 Aspose.Words.Run 节点具有相同的属性. 它忽略了使用的独特识别器来跟踪运行创建和修改的编辑会议。

NormalizeFieldTypes()

改變字段類型值 Aspose.Words.Fields.FieldChar.FieldType of Aspose.Words.Fields.FieldStart, Aspose.Words.Fields.FieldSeparator, Aspose.Words.Fields.FieldEnd在整个文件中,以便它们符合在字段代码中包含的字段类型。

public void NormalizeFieldTypes()

Remarks

使用此方法后文档变更影响字段类型。

要在文档的特定部分更改字段类型值,请使用 Aspose.Words.Range.NormalizeFieldTypes。

Protect(ProtectionType)

保护文档免受更改,而无需更改现有密码或分配随机密码。

public void Protect(ProtectionType type)

Parameters

type ProtectionType

指定文件的保护类型。

Remarks

当文件受保护时,用户只能进行有限的更改,例如添加笔记、进行审查或填写表格。

当您保护文档时,文档已经有保护密码时,现有保护密码不会被更改。

当您保护文档时,文档没有保护密码时,该方法会分配一个随机密码,使文档在 Microsoft Word 中无法不保护,但您仍然可以在 Aspose.Words 中不保护文档,因为在不保护时不需要密码。

Protect(防护类型, string)

保护文档免受变更,并可选设置保护密码。

public void Protect(ProtectionType type, string password)

Parameters

type ProtectionType

指定文件的保护类型。

password string

要保护文档的密码,请指定“零”或空字符串,如果您想要保护文档没有密码。

Remarks

当文件受保护时,用户只能进行有限的更改,例如添加笔记、进行审查或填写表格。

请注意,文档保护与写作保护不同. 写作保护是使用 Aspose.Words.Document.WriteProtection 指定。

RemoveBlankPages()

从文档中删除白色页面。

public List<int> RemoveBlankPages()

Returns

List < int >

页数列表被视为白色,并被删除。

Remarks

结果文档不会包含被认为是白色的页面,而其他内容,包括编号、标题/脚踏板和整体布局应保持不变。

页面被认为是白色,当页面体没有可见的内容时,例如:没有边界的空桌将被视为看不见,因此页面将被视为白色。

RemoveExternalSchemaReferences()

从此文档中删除外部 XML 图表参考。

public void RemoveExternalSchemaReferences()

RemoveMacros()

从文档中删除所有宏(VBA项目),以及工具栏和命令定制。

public void RemoveMacros()

Remarks

通过从文档中删除所有宏,您可以确保文档不包含宏病毒。

RenderToScale(海洋,海洋,海洋,海洋)

[CLSCompliant(false)]
public SizeF RenderToScale(int pageIndex, SKCanvas graphics, float x, float y, float scale)

Parameters

pageIndex int

graphics 可口可乐

x float

y float

scale float

Returns

SizeF

RenderToSize(航海,航海,航海,航海,航海)

[CLSCompliant(false)]
public float RenderToSize(int pageIndex, SKCanvas graphics, float x, float y, float width, float height)

Parameters

pageIndex int

graphics 可口可乐

x float

y float

width float

height float

Returns

float

Save(线条)

将文件存储到文件中,自动确定从扩展中保存格式。

public SaveOutputParameters Save(string fileName)

Parameters

fileName string

文件的名称. 如果文件与已确定的文件名已存在,现有文件已重写。

Returns

SaveOutputParameters

您可以随机使用的额外信息。

Save(字符串,SaveFormat)

将文件存储到指定的格式的文件中。

public SaveOutputParameters Save(string fileName, SaveFormat saveFormat)

Parameters

fileName string

文件的名称. 如果文件与已确定的文件名已存在,现有文件已重写。

saveFormat SaveFormat

保存文档的格式。

Returns

SaveOutputParameters

您可以随机使用的额外信息。

Save(字符串,SaveOptions)

将文件存储到文件中,使用所指定的存储选项。

public SaveOutputParameters Save(string fileName, SaveOptions saveOptions)

Parameters

fileName string

文件的名称. 如果文件与已确定的文件名已存在,现有文件已重写。

saveOptions SaveOptions

指定控制文档如何保存的选项. 可以是“零”。

Returns

SaveOutputParameters

您可以随机使用的额外信息。

Save(流量,SaveFormat)

将文件存储到一个流,使用指定的格式。

public SaveOutputParameters Save(Stream stream, SaveFormat saveFormat)

Parameters

stream Stream

流在哪里保存文件。

saveFormat SaveFormat

保存文档的格式。

Returns

SaveOutputParameters

您可以随机使用的额外信息。

Save(流量,SaveOptions)

将文档存储到一个流,使用所指定的存储选项。

public SaveOutputParameters Save(Stream stream, SaveOptions saveOptions)

Parameters

stream Stream

流在哪里保存文件。

saveOptions SaveOptions

指定控制文档如何存储的选项. 可以是“零”。如果这是“零”,文档将存储在二进制DOC格式。

Returns

SaveOutputParameters

您可以随机使用的额外信息。

StartTrackRevisions(字符串,日期)

开始自动标记您对文档的任何进一步更改,以编程方式作为修订更改。

public void StartTrackRevisions(string author, DateTime dateTime)

Parameters

author string

作者初步用于审查。

dateTime DateTime

用于审查的日期和时间。

Remarks

如果您打电话这个方法,然后编程对文档进行一些更改,保存文档,然后在 MS Word 中打开文档,您将看到这些更改作为修订。

目前 Aspose.Words 仅支持跟踪节点输入和删除。

自动跟踪变更在通过节点操作来修改此文件时以及使用 Aspose.Words.DocumentBuilder 时都支持。

此方法不会改变 Aspose.Words.Document.TrackRevisions 选项,也不会使用其值进行审查跟踪。

看也

Document . StopTrackRevisions ()

StartTrackRevisions(线条)

开始自动标记您对文档的任何进一步更改,以编程方式作为修订更改。

public void StartTrackRevisions(string author)

Parameters

author string

作者初步用于审查。

Remarks

如果您打电话这个方法,然后编程对文档进行一些更改,保存文档,然后在 MS Word 中打开文档,您将看到这些更改作为修订。

目前 Aspose.Words 仅支持跟踪节点输入和删除。

自动跟踪变更在通过节点操作来修改此文件时以及使用 Aspose.Words.DocumentBuilder 时都支持。

此方法不会改变 Aspose.Words.Document.TrackRevisions 选项,也不会使用其值进行审查跟踪。

看也

Document . StopTrackRevisions ()

StopTrackRevisions()

停止自动标记文件变更作为审查。

public void StopTrackRevisions()

看也

Document . StartTrackRevisions ( string , DateTime )

UnlinkFields()

在整个文档中解锁字段。

public void UnlinkFields()

Remarks

将整个文档中的所有字段替换为最新的结果。

在文档中使用 Aspose.Words.Range.UnlinkFields。

Unprotect()

从文件中删除保护,无论密码如何。

public void Unprotect()

Remarks

这种方法不会保护文档,即使它有一个保护密码。

请注意,文档保护与写作保护不同. 写作保护是使用 Aspose.Words.Document.WriteProtection 指定。

Unprotect(线条)

从文件中删除保护,如果正确的密码被指定。

public bool Unprotect(string password)

Parameters

password string

密码不保护文件。

Returns

bool

“真实”如果正确的密码被指定,并且文件不受保护。

Remarks

这种方法不会保护文档,只有当正确的密码被指定时。

请注意,文档保护与写作保护不同. 写作保护是使用 Aspose.Words.Document.WriteProtection 指定。

UpdateActualReferenceMarks()

更新 Aspose.Words.Notes.Footnote.ActualReferenceMark所有文件中的所有脚本和结论。

public void UpdateActualReferenceMarks()

Remarks

更新字段(Aspose.Words.Document.UpdateFields)可能需要获得正确的结果。

UpdateFields()

更新整个文档中的字段值。

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.

因此,您通常希望在保存之前拨打此方法,如果您修改了文档以编程的方式,并希望确保正确的(计算)字段值出现在保存文件中。

在执行邮件合并后不需要更新字段,因为邮件合并是一种字段更新,并自动更新文档中的所有字段。

此方法不更新所有字段类型. 有关支持的字段类型的详细列表,请参阅程序员指南。

此方法不更新与页面配置算法相关的字段(例如 PAGE、PAGES、PAGEREF)。页面配置相关字段在您提交文档或拨打 Aspose.Words.Document.UpdatePageLayout 时更新。

在更新字段之前使用 Aspose.Words.Document.NormalizeFieldTypes 方法,如果有影响字段类型的文档变更。

要在文档的特定部分更新字段,请使用 Aspose.Words.Range.UpdateFields。

UpdateListLabels()

更新列表标签文件中的所有列表项目。

public void UpdateListLabels()

Remarks

此方法更新列表标签属性,如 Aspose.Words.Lists.ListLabel.LabelValue 和 Aspose.Words.Lists.ListLabel.LabelString 为文件中的每个 Aspose.Words.Paragraph.ListLabel 对象。

此外,这种方法有时被暗示地称为在文档中更新字段,这是必要的,因为某些字段可能参考列表号(如 TOC 或 REF)需要它们更新。

UpdatePageLayout()

恢复文档的页面布局。

public void UpdatePageLayout()

Remarks

此方法将文档格式化为页面,并更新文档中的页数相关字段,如 PAGE、PAGES、PAGEREF 和 REF. 页面布局信息需要正确将文档转换为固定页面格式。

这种方法是自动引用,当您首先将文档转换为PDF,XPS,图像或打印它. 但是,如果您修改文档后播放,然后尝试播放它 - Aspose.Words 不会自动更新页面布局. 在这种情况下,您应该在播放之前拨打 Aspose.Words.Document.UpdatePageLayout。

UpdateTableLayout()

实施以前的方法到表列宽重新计算已知问题。

[Obsolete("Obsolete, column widths are re-calculated automatically before saving.")]
public void UpdateTableLayout()

Remarks

该方法被削弱,并将在几次发布中被删除。

UpdateThumbnail(ThumbnailGeneratingOptions)

更新 Aspose.Words.Properties.BuiltInDocumentProperties.根据所指定的选项,文档的图表。

public void UpdateThumbnail(ThumbnailGeneratingOptions options)

Parameters

options ThumbnailGeneratingOptions

使用的生成选项。

Remarks

Aspose.Words.Rendering.ThumbnailGeneratingOptions 允许您指定小型,大小和其他选项的来源。如果试图创建小组失败,则不会改变一个。

UpdateThumbnail()

更新 Aspose.Words.Properties.BuiltInDocumentProperties.Thumbnail 文档使用默认选项。

public void UpdateThumbnail()

UpdateWordCount()

更新词数文件的属性。

public void UpdateWordCount()

Remarks

Aspose.Words.Document.UpdateWordCount 重新计算和更新在 Wl26.BuiltInDokumentProperties 收藏中的字符、单词和段落属性。

请注意, Aspose.Words.Document.UpdateWordCount 不更新行数和页属性. 使用 Aspose.Words.Document.UpdateWordCount 过载并通过值作为一个参数来做到这一点。

当您使用评估版本时,评估水标也将被列入词数中。

UpdateWordCount(博尔)

更新字数文件属性,可选更新 Aspose.Words.Properties.BuiltInDocumentProperties.Lines属性。

public void UpdateWordCount(bool updateLinesCount)

Parameters

updateLinesCount bool

“真实”是指文件中的行数应计算的。

Remarks

此方法将重建文档的页面布局。

 中文