如何在 .NET 中使用样式

步骤 1：安装包

Aspose.Words FOSS for .NET 尚未发布 NuGet 包——请改为从源码构建库。克隆 https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git，然后使用 .NET SDK 在 Release 配置下构建 Aspose.Words.sln，并在项目中引用生成的 Aspose.Words 程序集。该库目标为 .NET Standard 2.0，因此可在 .NET Framework 4.6.2+ 和 .NET 6/8/10 上运行。

步骤 2：导入所需类

添加一个 using Aspose.Words; 指令——Style、StyleCollection、TableStyle、StyleType、StyleIdentifier、ConditionalStyle、ConditionalStyleCollection 和 ConditionalStyleType 都位于 Aspose.Words 命名空间中，与 Document 同在。

步骤 3：读取文档的样式集合

Document.Styles 返回一个 StyleCollection —— 文档中附加的每个内置和用户定义的 Style。StyleCollection.Count 报告它包含的样式数量，DefaultFont / DefaultParagraphFormat 描述文档范围的默认格式，新内容在应用任何显式样式之前会继承该默认格式。

步骤 4：可靠地查找样式

使用 StyleCollection 索引器 styles[name] 通过显示名称检索样式。对于内置样式，建议改用相同的索引器并使用 StyleIdentifier 枚举值 —— styles[sti] —— 名称是本地化的，但 StyleIdentifier 值不是，因此无论文档语言如何，使用标识符查找的方式相同。如果索引器未找到预期的样式，请检查 Style.Aliases，了解 Word 对同一样式识别的备用名称；在以编程方式删除或重命名样式之前，请检查 Style.BuiltIn，因为内置样式通常在文档其他位置通过名称被引用。

步骤 5：将样式应用于段落或运行

携带样式的格式对象同时公开一个 Style 属性（即 Style 对象本身）和一个 StyleName 属性（通过名称解析或创建样式的快捷方式）。设置 ParagraphFormat.Style 或 ParagraphFormat.StyleName 以应用段落样式，设置 Font.Style 或 Font.StyleName 以将字符样式应用于运行的格式。将 StyleName 赋予集合中不存在的名称会创建该样式——首先使用 StyleCollection 索引器确认样式是否已存在，或者直接赋值 Style 对象，如果这不是预期的行为。

步骤 6：构建样式层次结构

读取 BaseStyleName 以查找给定样式继承未设置格式的来源样式，LinkedStyleName 用于配对的段落/字符样式（如 Word 为内置样式定义的标题及其关联字符样式），NextParagraphStyleName 用于 Word 为在使用此样式的段落之后新键入的段落分配的样式。定义一组相关样式时设置 BaseStyleName——例如一系列标题样式应全部从同一基础样式继承字体选择——而不是在每个样式上重复相同的格式。

步骤 7：创建或复制样式

调用 StyleCollection.Add(type, name)，提供一个 StyleType（Paragraph、Character、Table 或 List）和一个名称，以创建一个新的空样式，然后根据需要设置其 Font 和 ParagraphFormat 属性。要复制现有样式——包括来自不同 Document 的 StyleCollection 的样式——请调用 StyleCollection.AddCopy(style)，而不是手动读取并重新应用每个格式属性。调用 Style.Remove() 可从其集合中删除样式。

步骤 8：配置表格样式和条件格式

TableStyle 在 Style 的基础上扩展了表布局属性——Alignment、CellSpacing、LeftIndent、Shading、VerticalAlignment，以及四个填充属性（LeftPadding、RightPadding、TopPadding、BottomPadding）——再加上 RowStripe 和 ColumnStripe，用于控制条纹图案在多少行或列上重复。若要进行按区域格式化，请配置 TableStyle.ConditionalStyles——一个保存每个区域一个 ConditionalStyle 的 ConditionalStyleCollection：FirstRow、LastRow、FirstColumn、LastColumn、OddRowBanding、EvenRowBanding、OddColumnBanding、EvenColumnBanding，以及四个角单元格（TopLeftCell、TopRightCell、BottomLeftCell、BottomRightCell）。每个 ConditionalStyle 拥有其自己的 Font、ParagraphFormat、Shading、Borders 和单元格填充，并由 Type 报告它代表的 ConditionalStyleType 区域；在这些区域上设置格式，而不是在单独的表格行上设置，以获得在表格编辑后仍然有效的条纹、标题行或角单元格格式。

步骤 9：重置或移除格式

调用 ConditionalStyle.ClearFormatting() 可重置单个条件区域，或调用 ConditionalStyleCollection.ClearFormatting() 一次性重置 TableStyle 上的所有区域。StyleCollection.ClearQuickStyleGallery() 会从 Word UI 的快速样式库中移除所有样式，但不删除样式本身——这对于在不影响文档内容的情况下精简库非常有用。