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
继承人
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
文件格式不被认可或支持。
文件似乎是腐败的,不能被加载。
有一个问题与文档,它应该报告到Aspose.Words开发人员。
有一个输入/输出例外。
文件是加密的,需要一个密码来打开,但您提供了一个错误的密码。
文件的名称不能是零或空字符串。
Document(字符串, LoadOptions)
从文件中打开现有文档 允许指定额外的选项,如加密密码。
public Document(string fileName, LoadOptions loadOptions)
Parameters
fileName
string
文件名称要打开。
loadOptions
LoadOptions
在下载文档时使用的额外选项可以是“零”。
Exceptions
UnsupportedFileFormatException
文件格式不被认可或支持。
文件似乎是腐败的,不能被加载。
有一个问题与文档,它应该报告到Aspose.Words开发人员。
有一个输入/输出例外。
文件是加密的,需要一个密码来打开,但您提供了一个错误的密码。
文件的名称不能是零或空字符串。
Document(Stream)
从流中打开现有文档,自动检测文件格式。
public Document(Stream stream)
Parameters
stream
Stream
流到哪里可以上传文件。
Remarks
文件必须在流的开始时存储,流必须支持随机定位。
Exceptions
UnsupportedFileFormatException
文件格式不被认可或支持。
文件似乎是腐败的,不能被加载。
有一个问题与文档,它应该报告到Aspose.Words开发人员。
有一个输入/输出例外。
文件是加密的,需要一个密码来打开,但您提供了一个错误的密码。
流量不能是零。
流量不支持阅读或搜索。
流是废弃的对象。
Document(流量, LoadOptions)
从流中打开现有文档 允许指定额外的选项,如加密密码。
public Document(Stream stream, LoadOptions loadOptions)
Parameters
stream
Stream
流程从哪里上传文件。
loadOptions
LoadOptions
在下载文档时使用的额外选项可以是“零”。
Remarks
文件必须在流的开始时存储,流必须支持随机定位。
Exceptions
UnsupportedFileFormatException
文件格式不被认可或支持。
文件似乎是腐败的,不能被加载。
有一个问题与文档,它应该报告到Aspose.Words开发人员。
有一个输入/输出例外。
文件是加密的,需要一个密码来打开,但您提供了一个错误的密码。
流量不能是零。
流量不支持阅读或搜索。
流是废弃的对象。
Properties
AttachedTemplate
接收或设置文件附带的模板的完整路径。
public string AttachedTemplate { get; set; }
财产价值
Remarks
空线意味着文件附加到正常模板。
Aspose.Words.Properties.BuiltInDocumentProperties.模板
Exceptions
如果你试图设置到“零”值。
AutomaticallyUpdateStyles
收到或设置一个标志表明文件中的风格是否更新,以匹配文件中的风格。附加模板每次文件在 MS Word 中打开时。
public bool AutomaticallyUpdateStyles { get; set; }
财产价值
Bibliography
获取 Aspose.Words.Document.Bibliography 对象,代表文档中可用的来源列表。
public Bibliography Bibliography { get; }
财产价值
BuiltInDocumentProperties
返回一份代表文件中的所有内置文件属性的集合。
public BuiltInDocumentProperties BuiltInDocumentProperties { get; }
财产价值
CompatibilityOptions
提供访问文档兼容性选项(即输入的用户偏好) Compatibility标签TAB Options 对话在词语中。
public CompatibilityOptions CompatibilityOptions { get; }
财产价值
Compliance
收到 OOXML 遵守版本,从加载文档内容中确定。它只适用于OOXML文件。
public OoxmlCompliance Compliance { get; }
财产价值
Remarks
如果您创建了一个新的空白文件或加载非OOXML文件,则将返回 Aspose.Words.Saving.OoxmlCompliance.Ecma376_2006 值。
CustomDocumentProperties
返回一份代表文档的所有自定义文档属性的集合。
public CustomDocumentProperties CustomDocumentProperties { get; }
财产价值
CustomXmlParts
获取或设置自定义 XML 数据存储部分的收藏。
public CustomXmlPartCollection CustomXmlParts { get; set; }
财产价值
Remarks
Aspose.Words 只在 OOXML 和 DOC 文档中加载和保存自定义 XML 部分。
这个财产不能。
ASPOSE.Words.Markup.CustomXml部分
DefaultTabStop
接收或设置默认选项卡停止之间的间隔(点)。
public double DefaultTabStop { get; set; }
财产价值
看也
DigitalSignatures
收到本文的数字签名收集及其验证结果。
public DigitalSignatureCollection DigitalSignatures { get; }
财产价值
Remarks
这些数字签名不会保存,当您将此 Aspose.Words.Document 对象保存到文件或流,因为保存或转换将产生与原始不同的文件,而原始数字签名将不再有效。
如果文件没有签名,它将包含零元素。
EndnoteOptions
提供控制本文中的终端笔记的编号和定位的选项。
public EndnoteOptions EndnoteOptions { get; }
财产价值
FieldOptions
得到一个 Aspose.Words.Fields.FieldOptions 对象,代表控制文件中的字段处理的选项。
public FieldOptions FieldOptions { get; }
财产价值
FirstSection
收到文档中的第一个部分。
public Section FirstSection { get; }
财产价值
Remarks
返回“零”如果没有部分。
FontSettings
接收或设置文档字体设置。
public FontSettings FontSettings { get; set; }
财产价值
Remarks
此属性允许根据文件指定字体设置. 如果设置为 , 默认静态字体设置 Aspose.Words.Fonts.FontSettings.DefaultInstance 将使用。
默认值是。
FootnoteOptions
提供控制本文中的脚笔数和定位的选项。
public FootnoteOptions FootnoteOptions { get; }
财产价值
Frameset
返回 Aspose.Words.Document.Frameset 示例,如果此文档代表框页面。
public Frameset Frameset { get; }
财产价值
Remarks
如果文件没有框架,财产的“零”值。
GlossaryDocument
在此文档或模板中获取或设置语音文件。对于文档中定义的 AutoText、AutoCorrect 和 Building Block 输入。
public GlossaryDocument GlossaryDocument { get; set; }
财产价值
Remarks
此财产将返回,如果文件没有语音文件。
您可以通过创建 Aspose.Words.BuildingBlocks.GlossaryDocument 对象并将其分配到文档中添加一个语音文档。
Aspose.Words.BuildingBlocks.Glossary文档
GrammarChecked
返回“真实”如果文件已被检查为语法。
public bool GrammarChecked { get; set; }
财产价值
Remarks
要将文本中的语法复制,将此属性设置为“虚假”。
HasMacros
返回“真实”如果文件有一个VBA项目(宏)。
public bool HasMacros { get; }
财产价值
看也
Document . RemoveMacros ()
HasRevisions
返回“真实”如果文件有任何跟踪的变化。
public bool HasRevisions { get; }
财产价值
Remarks
此属性是比较 Aspose.Words.RevisionCollection.Count 到零的缩写。
HyphenationOptions
提供文档催眠选项的访问。
public HyphenationOptions HyphenationOptions { get; }
财产价值
IncludeTextboxesFootnotesEndnotesInStat
指定是否在字数统计中包含文本盒、脚笔和终点笔记。
public bool IncludeTextboxesFootnotesEndnotesInStat { get; set; }
财产价值
JustificationMode
收到或设置一个文档的字符空间调整。
public JustificationMode JustificationMode { get; set; }
财产价值
LastSection
收到文件中的最后一部分。
public Section LastSection { get; }
财产价值
Remarks
返回“零”如果没有部分。
LayoutOptions
收到 Aspose.Words.Layout.LayoutOptions 对象,代表控制该文档的配置过程的选项。
public LayoutOptions LayoutOptions { get; }
财产价值
MailMerge
返回 Aspose.Words.MailMerging.MailMerge 对象,代表该文件的邮件合并功能。
public MailMerge MailMerge { get; }
财产价值
MailMergeSettings
收到或设置包含所有邮件合并信息文件的对象。
public MailMergeSettings MailMergeSettings { get; set; }
财产价值
Remarks
您可以使用此对象指定文件的邮件合并数据来源,当用户打开该文件时,将此信息(与可用的数据字段一起)显示在 Microsoft Word. 或者您可以使用此对象查询邮件合并设置,用户在 Microsoft Word 为此文件中指定。
这个对象从来没有。
NodeType
返回 Aspose.Words.NodeType.Document。
public override NodeType NodeType { get; }
财产价值
OriginalFileName
获取文件的原始文件名。
public string OriginalFileName { get; }
财产价值
Remarks
返回,如果文档从流中加载或创建空白。
OriginalLoadFormat
获取该对象上传的原始文档的格式。
public LoadFormat OriginalLoadFormat { get; }
财产价值
Remarks
如果您创建了一个新的白色文档,则返回 Aspose.Words.LoadFormat.Doc 值。
PackageCustomParts
通过“未知关系”获取或设置与 OOXML 包链接的自定义部分(自定义内容)的收藏。
public CustomPartCollection PackageCustomParts { get; set; }
财产价值
Remarks
不要将这些自定义部分与自定义 XML 数据混淆. 如果您需要访问自定义 XML 部分,请使用 Aspose.Words.Document.CustomXmlParts 属性。
本集包含 OOXML 部分,其主人是 OOXML 包,其目标是“未知的关系”。 有关更多信息,请参阅 Aspose.Words.Markup.CustomPart。
Aspose.Words 只在 OOXML 文档中加载和保存自定义部分。
这个财产不能。
首頁 〉外文書 〉文學 〉文學 〉Markup.CustomPart
PageCount
收到文件中的页数,根据最新的页面配置操作计算。
public int PageCount { get; }
财产价值
看也
Document . UpdatePageLayout ()
ProtectionType
获取目前活跃的文件保护类型。
public ProtectionType ProtectionType { get; }
财产价值
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; }
财产价值
RemovePersonalInformation
收到或设置指示 Microsoft Word 将从评论、审查和保存文件时的文件属性。
public bool RemovePersonalInformation { get; set; }
财产价值
Revisions
收到本文中存在的审查(跟踪变更)的集合。
public RevisionCollection Revisions { get; }
财产价值
Remarks
返回收藏是“现场”收藏,即如果您删除包含审查的文件部分,则删除的审查将自动从收藏中消失。
RevisionsView
收到或设置一个值,表明是否与文档的原始或修订版本工作。
public RevisionsView RevisionsView { get; set; }
财产价值
Remarks
默认值是 首頁 〉外文書 〉文學 〉文學 〉RevisionsView.Original.
Sections
返回一份代表文件中的所有部分的集合。
public SectionCollection Sections { get; }
财产价值
ShadeFormData
指定是否在形状字段上旋转灰色阴影。
public bool ShadeFormData { get; set; }
财产价值
ShowGrammaticalErrors
说明是否在本文中显示语法错误。
public bool ShowGrammaticalErrors { get; set; }
财产价值
ShowSpellingErrors
指定是否在本文中显示输入错误。
public bool ShowSpellingErrors { get; set; }
财产价值
SpellingChecked
返回“真实”如果文件已被检查。
public bool SpellingChecked { get; set; }
财产价值
Remarks
要在文档中删除字符,将此属性设置为“虚假”。
Theme
获取 Aspose.Words.Document.Theme 对该文件的对象。
public Theme Theme { get; }
财产价值
TrackRevisions
正确的是,当此文档在Microsoft Word中编辑时,是否会跟踪更改。
public bool TrackRevisions { get; set; }
财产价值
Remarks
设置此选项仅指示 Microsoft Word 是否启动或关闭轨道更改. 此属性不会影响您通过 Aspose.Words 编程进行文档的更改。
如果您想要自动跟踪变更,因为它们是由 Aspose.Words 编程,请使用 Aspose.Words.Document.StartTrackRevisions(System.String,System.DateTime) 方法。
Variables
返回添加到文档或模板的变量集合。
public VariableCollection Variables { get; }
财产价值
VbaProject
获取或设置 Aspose.Words.Document.VbaProject。
public VbaProject VbaProject { get; set; }
财产价值
VersionsCount
获取在 DOC 文档中存储的文档版本的数量。
public int VersionsCount { get; }
财产价值
Remarks
Microsoft Word 版本可通过文件/版本菜单访问,Microsoft Word 仅支持 DOC 文件的版本。
此属性允许检测是否有文档版本存储在本文档之前它在 Aspose.Words 中打开. Aspose.Words 没有其他支持文档版本. 如果您使用 Aspose.Words 保存该文档,文档将存储没有版本。
ViewOptions
提供如何控制文档在 Microsoft Word 中显示的选项。
public ViewOptions ViewOptions { get; }
财产价值
Watermark
提供文件水标的访问。
public Watermark Watermark { get; }
财产价值
WebExtensionTaskPanes
返回代表任务板插件列表的集合。
public TaskPaneCollection WebExtensionTaskPanes { get; }
财产价值
WriteProtection
提供访问文档写作保护选项。
public WriteProtection WriteProtection { get; }
财产价值
Methods
Accept(DocumentVisitor)
接受访客。
public override bool Accept(DocumentVisitor visitor)
Parameters
visitor
DocumentVisitor
参观者将参观节点。
Returns
如果所有节点都被访问,则是真实的;如果 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
由参观者采取的行动。
AcceptStart(DocumentVisitor)
接受访问者访问文档的开始。
public override VisitorAction AcceptStart(DocumentVisitor visitor)
Parameters
visitor
DocumentVisitor
文件访问者。
Returns
由参观者采取的行动。
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
克隆文档。
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
Remarks
结果文档应该看起来像MS Word中的文档,就好像我们已经完成了“印刷特定的页面” - 编号,头/脚和交叉表的布局将保留。但由于大量的色调,同时减少页数,整个配置的匹配是一个安静复杂的任务,需要大量的努力。根据文档的复杂性,与源文档相比,结果文档内容的布局可能有微小的差异。任何反馈都会受到极大的欣赏。
GetPageInfo(因特)
获取页面大小、方向和有关可能对印刷或播放有用的页面的其他信息。
public PageInfo GetPageInfo(int pageIndex)
Parameters
pageIndex
int
基于0的页面指数。
Returns
JoinRunsWithSameFormatting()
加入在文件的所有段落中以相同的格式运行。
public int JoinRunsWithSameFormatting()
Returns
加入的数量:当 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
页数列表被视为白色,并被删除。
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
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
Save(线条)
将文件存储到文件中,自动确定从扩展中保存格式。
public SaveOutputParameters Save(string fileName)
Parameters
fileName
string
文件的名称. 如果文件与已确定的文件名已存在,现有文件已重写。
Returns
您可以随机使用的额外信息。
Save(字符串,SaveFormat)
将文件存储到指定的格式的文件中。
public SaveOutputParameters Save(string fileName, SaveFormat saveFormat)
Parameters
fileName
string
文件的名称. 如果文件与已确定的文件名已存在,现有文件已重写。
saveFormat
SaveFormat
保存文档的格式。
Returns
您可以随机使用的额外信息。
Save(字符串,SaveOptions)
将文件存储到文件中,使用所指定的存储选项。
public SaveOutputParameters Save(string fileName, SaveOptions saveOptions)
Parameters
fileName
string
文件的名称. 如果文件与已确定的文件名已存在,现有文件已重写。
saveOptions
SaveOptions
指定控制文档如何保存的选项. 可以是“零”。
Returns
您可以随机使用的额外信息。
Save(流量,SaveFormat)
将文件存储到一个流,使用指定的格式。
public SaveOutputParameters Save(Stream stream, SaveFormat saveFormat)
Parameters
stream
Stream
流在哪里保存文件。
saveFormat
SaveFormat
保存文档的格式。
Returns
您可以随机使用的额外信息。
Save(流量,SaveOptions)
将文档存储到一个流,使用所指定的存储选项。
public SaveOutputParameters Save(Stream stream, SaveOptions saveOptions)
Parameters
stream
Stream
流在哪里保存文件。
saveOptions
SaveOptions
指定控制文档如何存储的选项. 可以是“零”。如果这是“零”,文档将存储在二进制DOC格式。
Returns
您可以随机使用的额外信息。
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
“真实”如果正确的密码被指定,并且文件不受保护。
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
此方法将重建文档的页面布局。