Aspose.Words For .NET是一種高級Word文檔處理API，用于執行各種文檔管理和操作任務。API支持生成，修改，轉換，呈現和打印文檔，而無需在跨平臺應用程序中直接使用Microsoft Word。此外，API支持所有流行的Word處理文件格式，并允許將Word文檔導出或轉換為固定布局文件格式和最常用的圖像/多媒體格式。

>>Aspose.Words for .NET已經更新至v20.4，Aspose.Words for .Net更新至新版本v20.4，主要新增5大特點，包括：支持閱讀PDF文檔；提供了更改亞洲段落間距和縮進的功能；為PDF渲染添加了圖像插值選項；添加了新的模式3D形狀渲染；圖表數據標簽和系列的擴展API。，點擊下載體驗

Microsoft Word文檔中的列表是一組列表格式屬性。每個列表最多可以具有9個級別，并且分別為每個級別定義了格式設置屬性，例如數字樣式，起始值，縮進，制表符位置等。List對象始終屬于ListCollection集合。

本主題描述如何使用Aspose.Words以編程方式使用列表。可以在文檔中使用列表來格式化，排列和強調文本。列表是組織文檔中數據的一種好方法，它使讀者更容易理解要點。

通過應用列表格式創建列表

Aspose.Words允許通過應用列表格式輕松創建列表。DocumentBuilder提供了DocumentBuilder.ListFormat屬性，該屬性返回ListFormat對象。該對象有幾種方法可以開始和結束列表以及增加/減少縮進量。 Microsoft Word中有兩種常規類型的列表：項目符號和編號。

• 要啟動項目符號列表，請調用 ListFormat.ApplyBulletDefault 。
• 要開始編號列表，請調用 ListFormat.ApplyNumberDefault 。

項目符號或編號和格式將添加到當前段落，并使用DocumentBuilder創建所有其他段落， 直到 調用ListFormat.RemoveNumbers停止項目符號列表格式。 在Word文檔中，列表最多可以包含九個級別。每個級別的列表格式指定使用的項目符號或編號，左縮進，項目符號與文本之間的間距等。

• 要將當前段落的列表級別增加一級，請調用ListFormat.ListIndent。
• 要將當前段落的列表級別降低一級，請調用 ListFormat.ListOutdent。

下面的示例顯示了如何構建多級列表。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.ListFormat.ApplyNumberDefault();

builder.Writeln("Item 1");
builder.Writeln("Item 2");

builder.ListFormat.ListIndent();

builder.Writeln("Item 2.1");
builder.Writeln("Item 2.2");

builder.ListFormat.ListIndent();

builder.Writeln("Item 2.2.1");
builder.Writeln("Item 2.2.2");

builder.ListFormat.ListOutdent();

builder.Writeln("Item 2.3");

builder.ListFormat.ListOutdent();

builder.Writeln("Item 3");

builder.ListFormat.RemoveNumbers();
dataDir = dataDir + "DocumentBuilderSetMultilevelListFormatting_out.doc";
doc.Save(dataDir);

重新啟動每個節的列表

使用List.IsRestartAtEachSection屬性可以重新啟動每個節的列表。請注意，僅RTF，DOC和DOCX文檔格式支持此選項。僅當OoxmlCompliance高于Ecma376時，此選項才會寫入DOCX。下面的代碼示例演示如何創建列表并為每個部分重新啟動它。

Document doc = new Document();

doc.Lists.Add(ListTemplate.NumberDefault);

List list = doc.Lists[0];

// Set true to specify that the list has to be restarted at each section.
list.IsRestartAtEachSection = true;

DocumentBuilder builder = new DocumentBuilder(doc);

builder.ListFormat.List = list;

for (int i = 1; i < 45; i++) 
{ 
   builder.Writeln(String.Format("List Item {0}", i)); 

   // Insert section break. 
   if (i == 15) 
      builder.InsertBreak(BreakType.SectionBreakNewPage); 
} 

// IsRestartAtEachSection will be written only if compliance is higher then OoxmlComplianceCore.Ecma376 
OoxmlSaveOptions options = new OoxmlSaveOptions(); 
options.Compliance = OoxmlCompliance.Iso29500_2008_Transitional; 

dataDir = dataDir + "RestartAtEachSection_out.docx"; 

// Save the document to disk. 
doc.Save(dataDir, options);