C#/VB.NET 在 Word 文档中插入列表

在 Word 文档中，列表被用于概述、排列和强调文本，使用户可以轻松地浏览和理解一系列事项。Word 中有三种不同类型的列表，即编号列表、项目符号列表和多级列表。编号列表用于具有序列或优先级的项目，例如一系列说明。项目符号列表用于没有特定优先级的项目，例如功能或事实清单。多级列表用于需要顺序排列且希望每个段落单独编号的情况。

在本文中，您将学习如何使用 Spire.Doc for .NET 在 C# 和 VB.NET 中向 Word 文档插入这些类型的列表。

在 Word 中插入编号列表
在 Word 中插入项目符号列表
在 Word 中插入多级编号列表
在 Word 中插入多级混合类型列表

安装 Spire.Doc for .NET

首先，您需要将 Spire.Doc for.NET 包含的 DLL 文件作为引用添加到您的 .NET 项目中。DLL 文件可以从此链接下载，也可以通过 NuGet 安装。

PM> Install-Package Spire.Doc

在 Word 中插入编号列表

Spire.Doc for .NET 提供了 ListStyle 类，您可以使用该类创建编号列表样式或项目符号样式。然后，可以使用 Paragraph.ListFormat.ApplyStyle() 方法将列表样式应用于段落。创建编号列表的步骤如下。

创建一个 Document 对象。
使用 Document.AddSection() 方法添加一个节。
创建 ListStyle 类的实例，指定列表类型为编号。
通过 ListStyle.Levels[index] 属性获取列表的特定级别，并通过 ListLevel.PatternType 属性设置编号类型。
使用 Document.ListStyles.Add() 方法将列表样式添加到文档中。
使用 Section.AddParagraph() 方法向文档添加几个段落。
使用 Paragraph.ListFormat.ApplyStyle() 方法将列表样式应用于特定段落。
通过 Paragraph.ListFormat.ListLevelNumber 属性指定列表级别。
使用 Document.SaveToFile() 方法将文档保存为 Word 文件。

C#
VB.NET

using Spire.Doc;
using Spire.Doc.Documents;

namespace CreateOrderedList
{
    class Program
    {
        static void Main(string[] args)
        {
            //创建一个Document对象
            Document document = new Document();

            //添加一个节
            Section section = document.AddSection();

            //创建编号列表样式
            ListStyle listStyle = new ListStyle(document, ListType.Numbered);
            listStyle.Name = "numberedList";
            listStyle.Levels[0].PatternType = ListPatternType.DecimalEnclosedParen;
            listStyle.Levels[0].TextPosition = 20;
            document.ListStyles.Add(listStyle);

            //添加一个段落
            Paragraph paragraph = section.AddParagraph();
            paragraph.AppendText("必需的Web开发技能:");
            paragraph.Format.AfterSpacing = 5f;

            //添加段落并对其应用编号列表样式
            paragraph = section.AddParagraph();
            paragraph.AppendText("HTML");
            paragraph.ListFormat.ApplyStyle("numberedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            //再添加四个段落，并将编号列表样式应用于特定段落
            paragraph = section.AddParagraph();
            paragraph.AppendText("CSS");
            paragraph.ListFormat.ApplyStyle("numberedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            paragraph = section.AddParagraph();
            paragraph.AppendText("JavaScript");
            paragraph.ListFormat.ApplyStyle("numberedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            paragraph = section.AddParagraph();
            paragraph.AppendText("Python");
            paragraph.ListFormat.ApplyStyle("numberedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            paragraph = section.AddParagraph();
            paragraph.AppendText("MySQL");
            paragraph.ListFormat.ApplyStyle("numberedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            //将文档保存为Word文件
            document.SaveToFile("插入编号列表.docx", FileFormat.Docx);
        }
    }
}

Imports Spire.Doc
Imports Spire.Doc.Documents

Namespace CreateOrderedList
    Friend Class Program
        Private Shared Sub Main(ByVal args As String())
            '创建一个Document对象
            Dim document As Document = New Document()

            '添加一个节
            Dim section As Section = document.AddSection()

            '创建编号列表样式
            Dim listStyle As ListStyle = New ListStyle(document, ListType.Numbered)
            listStyle.Name = "numberedList"
            listStyle.Levels(0).PatternType = ListPatternType.DecimalEnclosedParen
            listStyle.Levels(0).TextPosition = 20
            document.ListStyles.Add(listStyle)

            '添加一个段落
            Dim paragraph As Paragraph = section.AddParagraph()
            paragraph.AppendText("必需的Web开发技能:")
            paragraph.Format.AfterSpacing = 5F

            '添加段落并对其应用编号列表样式
            paragraph = section.AddParagraph()
            paragraph.AppendText("HTML")
            paragraph.ListFormat.ApplyStyle("numberedList")
            paragraph.ListFormat.ListLevelNumber = 0

            '再添加四个段落，并将编号列表样式应用于特定段落
            paragraph = section.AddParagraph()
            paragraph.AppendText("CSS")
            paragraph.ListFormat.ApplyStyle("numberedList")
            paragraph.ListFormat.ListLevelNumber = 0

            paragraph = section.AddParagraph()
            paragraph.AppendText("JavaScript")
            paragraph.ListFormat.ApplyStyle("numberedList")
            paragraph.ListFormat.ListLevelNumber = 0

            paragraph = section.AddParagraph()
            paragraph.AppendText("Python")
            paragraph.ListFormat.ApplyStyle("numberedList")
            paragraph.ListFormat.ListLevelNumber = 0

            paragraph = section.AddParagraph()
            paragraph.AppendText("MySQL")
            paragraph.ListFormat.ApplyStyle("numberedList")
            paragraph.ListFormat.ListLevelNumber = 0

            '将文档保存为Word文件
            document.SaveToFile("插入编号列表.docx", FileFormat.Docx)
        End Sub
    End Class
End Namespace

C#/VB.NET 在 Word 文档中插入列表

在 Word 中插入项目符号列表

创建项目符号列表的过程与创建编号列表的过程类似。不同之处在于，创建列表样式时，必须将列表类型指定为“项目符号”，并为其设置项目符号。以下是详细步骤。

创建一个 Document 对象。
使用 Document.AddSection() 方法添加一个节。
创建 ListStyle 类的实例，指定列表类型为项目符号。
通过 ListStyle.Levels[index] 属性获取列表的特定级别，并通过 ListLevel.BulletCharacter 属性设置项目符号。
使用 Document.ListStyles.Add() 方法将列表样式添加到文档中。
使用 Section.AddParagraph() 方法向文档添加几个段落。
使用 Paragraph.ListFormat.ApplyStyle() 方法将列表样式应用于特定段落。
通过 Paragraph.ListFormat.ListLevelNumber 属性指定列表级别。
使用 Document.SaveToFile() 方法将文档保存为 Word文件。

C#
VB.NET

using Spire.Doc;
using Spire.Doc.Documents;

namespace CreateUnorderedList
{
    class Program
    {
        static void Main(string[] args)
        {
            //创建一个Document对象
            Document document = new Document();

            //添加一个节
            Section section = document.AddSection();

            //创建项目符号列表样式
            ListStyle listStyle = new ListStyle(document, ListType.Bulleted);
            listStyle.Name = "bulletedList";
            listStyle.Levels[0].BulletCharacter = "\x00B7";
            listStyle.Levels[0].CharacterFormat.FontName = "Symbol";
            listStyle.Levels[0].TextPosition = 20;
            document.ListStyles.Add(listStyle);

            //添加一个段落
            Paragraph paragraph = section.AddParagraph();
            paragraph.AppendText("计算机科学科目:");
            paragraph.Format.AfterSpacing = 5f;

            //添加段落并对其应用项目符号列表样式
            paragraph = section.AddParagraph();
            paragraph.AppendText("数据结构");
            paragraph.ListFormat.ApplyStyle("bulletedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            //再添加五个段落，并将项目符号列表样式应用于特定段落
            paragraph = section.AddParagraph();
            paragraph.AppendText("演算法");
            paragraph.ListFormat.ApplyStyle("bulletedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            paragraph = section.AddParagraph();
            paragraph.AppendText("计算机网络");
            paragraph.ListFormat.ApplyStyle("bulletedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            paragraph = section.AddParagraph();
            paragraph.AppendText("操作系统");
            paragraph.ListFormat.ApplyStyle("bulletedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            paragraph = section.AddParagraph();
            paragraph.AppendText("C语言程序设计");
            paragraph.ListFormat.ApplyStyle("bulletedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            paragraph = section.AddParagraph();
            paragraph.AppendText("计算理论");
            paragraph.ListFormat.ApplyStyle("bulletedList");
            paragraph.ListFormat.ListLevelNumber = 0;

            //保存结果文档
            document.SaveToFile("项目符号列表.docx", FileFormat.Docx);
        }
    }
}

Imports Spire.Doc
Imports Spire.Doc.Documents

Namespace CreateUnorderedList
    Friend Class Program
        Private Shared Sub Main(ByVal args As String())
            '创建一个Document对象
            Dim document As Document = New Document()

            '添加一个节
            Dim section As Section = document.AddSection()

            '创建项目符号列表样式
            Dim listStyle As ListStyle = New ListStyle(document, ListType.Bulleted)
            listStyle.Name = "bulletedList"
            listStyle.Levels(0).BulletCharacter = "•"
            listStyle.Levels(0).CharacterFormat.FontName = "Symbol"
            listStyle.Levels(0).TextPosition = 20
            document.ListStyles.Add(listStyle)

            '添加一个段落
            Dim paragraph As Paragraph = section.AddParagraph()
            paragraph.AppendText("计算机科学科目:")
            paragraph.Format.AfterSpacing = 5F

            '添加段落并对其应用项目符号列表样式
            paragraph = section.AddParagraph()
            paragraph.AppendText("数据结构")
            paragraph.ListFormat.ApplyStyle("bulletedList")
            paragraph.ListFormat.ListLevelNumber = 0

            '再添加五个段落，并将项目符号列表样式应用于特定段落
            paragraph = section.AddParagraph()
            paragraph.AppendText("演算法")
            paragraph.ListFormat.ApplyStyle("bulletedList")
            paragraph.ListFormat.ListLevelNumber = 0

            paragraph = section.AddParagraph()
            paragraph.AppendText("计算机网络")
            paragraph.ListFormat.ApplyStyle("bulletedList")
            paragraph.ListFormat.ListLevelNumber = 0

            paragraph = section.AddParagraph()
            paragraph.AppendText("操作系统")
            paragraph.ListFormat.ApplyStyle("bulletedList")
            paragraph.ListFormat.ListLevelNumber = 0

            paragraph = section.AddParagraph()
            paragraph.AppendText("C语言程序设计")
            paragraph.ListFormat.ApplyStyle("bulletedList")
            paragraph.ListFormat.ListLevelNumber = 0

            paragraph = section.AddParagraph()
            paragraph.AppendText("计算理论")
            paragraph.ListFormat.ApplyStyle("bulletedList")
            paragraph.ListFormat.ListLevelNumber = 0

            '保存结果文档
            document.SaveToFile("项目符号列表.docx", FileFormat.Docx)
        End Sub
    End Class
End Namespace

C#/VB.NET 在 Word 文档中插入列表

在 Word 中插入多级编号列表

多级列表至少由两个不同的级别组成。嵌套列表的每个级别都由 ListStyle.Levels[index] 属性表示，通过该属性可以设置某个级别的编号类型和前缀。以下是在 Word 中创建多级编号列表的步骤。

创建一个 Document 对象。
使用 Document.AddSection() 方法添加一个节。
创建 ListStyle 类的实例，将列表类型指定为 Numbered。
通过 ListStyle.Levels[index] 属性获取列表的特定级别，并设置编号类型和前缀。
使用 Document.ListStyles.Add() 方法将列表样式添加到文档中。
使用 Section.AddParagraph() 方法将多个段落添加到文档中。
使用 Paragraph.ListFormat.ApplyStyle() 方法将列表样式应用于特定段落。
通过 Paragraph.ListFormat.ListLevelNumber 属性指定列表级别。
使用 Document.SaveToFile() 方法将文档保存到 Word 文件中。

C#
VB.NET

using Spire.Doc;
using Spire.Doc.Documents;

namespace CreateMultiLevelList
{
    class Program
    {
        static void Main(string[] args)
        {
            //创建一个Document对象
            Document document = new Document();

            //添加一个节
            Section section = document.AddSection();

            //创建编号列表样式，指定每个级别的编号前缀和图案类型
            ListStyle listStyle = new ListStyle(document, ListType.Numbered);
            listStyle.Name = "levelstyle";
            listStyle.Levels[0].PatternType = ListPatternType.Arabic;
            listStyle.Levels[0].TextPosition = 20;
            listStyle.Levels[1].NumberPrefix = "\x0000.";
            listStyle.Levels[1].PatternType = ListPatternType.Arabic;
            listStyle.Levels[2].NumberPrefix = "\x0000.\x0001.";
            listStyle.Levels[2].PatternType = ListPatternType.Arabic;
            document.ListStyles.Add(listStyle);

            //添加一个段落
            Paragraph paragraph = section.AddParagraph();
            paragraph.AppendText("这是一个多级编号列表:");
            paragraph.Format.AfterSpacing = 5f;

            //添加段落并对其应用编号列表样式
            paragraph = section.AddParagraph();
            paragraph.AppendText("第一项");
            paragraph.ListFormat.ApplyStyle("levelstyle");
            paragraph.ListFormat.ListLevelNumber = 0;

            //再添加五个段落，并将编号列表样式应用于特定段落
            paragraph = section.AddParagraph();
            paragraph.AppendText("第二项");
            paragraph.ListFormat.ApplyStyle("levelstyle");
            paragraph.ListFormat.ListLevelNumber = 0;

            paragraph = section.AddParagraph();
            paragraph.AppendText("第一个子项");
            paragraph.ListFormat.ApplyStyle("levelstyle");
            paragraph.ListFormat.ListLevelNumber = 1;

            paragraph = section.AddParagraph();
            paragraph.AppendText("第二个子项");
            paragraph.ListFormat.ContinueListNumbering();
            paragraph.ListFormat.ApplyStyle("levelstyle");

            paragraph = section.AddParagraph();
            paragraph.AppendText("一个子项");
            paragraph.ListFormat.ApplyStyle("levelstyle");
            paragraph.ListFormat.ListLevelNumber = 2;

            paragraph = section.AddParagraph();
            paragraph.AppendText("第三项");
            paragraph.ListFormat.ApplyStyle("levelstyle");
            paragraph.ListFormat.ListLevelNumber = 0;

            //保存结果文档
            document.SaveToFile("多级编号列表.docx", FileFormat.Docx);
        }
    }
}

Imports Spire.Doc
Imports Spire.Doc.Documents

Namespace CreateMultiLevelList
    Friend Class Program
        Private Shared Sub Main(ByVal args As String())
            '创建一个Document对象
            Dim document As Document = New Document()

            '添加一个节
            Dim section As Section = document.AddSection()

            '创建编号列表样式，指定每个级别的编号前缀和图案类型
            Dim listStyle As ListStyle = New ListStyle(document, ListType.Numbered)
            listStyle.Name = "levelstyle"
            listStyle.Levels(0).PatternType = ListPatternType.Arabic
            listStyle.Levels(0).TextPosition = 20
            listStyle.Levels(1).NumberPrefix = vbNullChar & "."
            listStyle.Levels(1).PatternType = ListPatternType.Arabic
            listStyle.Levels(2).NumberPrefix = vbNullChar & "." & ChrW(1) & "."
            listStyle.Levels(2).PatternType = ListPatternType.Arabic
            document.ListStyles.Add(listStyle)

            '添加一个段落
            Dim paragraph As Paragraph = section.AddParagraph()
            paragraph.AppendText("这是一个多级编号列表:")
            paragraph.Format.AfterSpacing = 5F

            '添加段落并对其应用编号列表样式
            paragraph = section.AddParagraph()
            paragraph.AppendText("第一项")
            paragraph.ListFormat.ApplyStyle("levelstyle")
            paragraph.ListFormat.ListLevelNumber = 0

            '再添加五个段落，并将编号列表样式应用于特定段落
            paragraph = section.AddParagraph()
            paragraph.AppendText("第二项")
            paragraph.ListFormat.ApplyStyle("levelstyle")
            paragraph.ListFormat.ListLevelNumber = 0

            paragraph = section.AddParagraph()
            paragraph.AppendText("第一个子项")
            paragraph.ListFormat.ApplyStyle("levelstyle")
            paragraph.ListFormat.ListLevelNumber = 1

            paragraph = section.AddParagraph()
            paragraph.AppendText("第二个子项")
            paragraph.ListFormat.ContinueListNumbering()
            paragraph.ListFormat.ApplyStyle("levelstyle")

            paragraph = section.AddParagraph()
            paragraph.AppendText("一个子项")
            paragraph.ListFormat.ApplyStyle("levelstyle")
            paragraph.ListFormat.ListLevelNumber = 2

            paragraph = section.AddParagraph()
            paragraph.AppendText("第三项")
            paragraph.ListFormat.ApplyStyle("levelstyle")
            paragraph.ListFormat.ListLevelNumber = 0

            '保存结果文档
            document.SaveToFile("多级编号列表.docx", FileFormat.Docx)
        End Sub
    End Class
End Namespace

C#/VB.NET 在 Word 文档中插入列表

在 Word 中插入多级混合类型列表

在某些情况下，您可能希望在多级列表中混合数字和符号项目符号。要创建混合类型列表，只需要创建编号列表样式和项目符号列表样式，并将它们应用于不同的段落。具体步骤如下。

创建一个 Document 对象。
使用 Document.AddSection() 方法添加一个节。
创建编号列表样式和项目符号列表样式。
使用 Section.AddParagraph() 方法将多个段落添加到文档中。
使用 Paragraph.ListFormat.ApplyStyle() 方法将不同的列表样式应用于不同的段落。
使用 Document.SaveToFile() 方法将文档保存到 Word 文件中。

C#
VB.NET

using Spire.Doc;
using Spire.Doc.Documents;

namespace CreateMultilevelMixedList
{
    class Program
    {
        static void Main(string[] args)
        {
            //创建一个Document对象
            Document document = new Document();

            //添加一个节
            Section section = document.AddSection();

            //创建编号列表样式
            ListStyle numberedListStyle = new ListStyle(document, ListType.Numbered);
            numberedListStyle.Name = "numberedStyle";
            numberedListStyle.Levels[0].PatternType = ListPatternType.Arabic;
            numberedListStyle.Levels[0].TextPosition = 20;
            numberedListStyle.Levels[1].PatternType = ListPatternType.LowLetter;
            document.ListStyles.Add(numberedListStyle);

            //创建项目符号列表样式
            ListStyle bulletedListStyle = new ListStyle(document, ListType.Bulleted);
            bulletedListStyle.Name = "bulltedStyle";
            bulletedListStyle.Levels[2].BulletCharacter = "\x002A";
            bulletedListStyle.Levels[2].CharacterFormat.FontName = "Symbol";
            document.ListStyles.Add(bulletedListStyle);

            //添加段落
            Paragraph paragraph = section.AddParagraph();
            paragraph.AppendText("这是一个多级混合列表:");
            paragraph.Format.AfterSpacing = 5f;

            //添加段落并对其应用编号列表样式
            paragraph = section.AddParagraph();
            paragraph.AppendText("第一项");
            paragraph.ListFormat.ApplyStyle("numberedStyle");
            paragraph.ListFormat.ListLevelNumber = 0;

            //再添加五个段落，并对其应用不同的列表样式
            paragraph = section.AddParagraph();
            paragraph.AppendText("第一个子项");
            paragraph.ListFormat.ApplyStyle("numberedStyle");
            paragraph.ListFormat.ListLevelNumber = 1;

            paragraph = section.AddParagraph();
            paragraph.AppendText("第二个子项");
            paragraph.ListFormat.ListLevelNumber = 1;
            paragraph.ListFormat.ApplyStyle("numberedStyle");

            paragraph = section.AddParagraph();
            paragraph.AppendText("子项1");
            paragraph.ListFormat.ApplyStyle("bulltedStyle");
            paragraph.ListFormat.ListLevelNumber = 2;

            paragraph = section.AddParagraph();
            paragraph.AppendText("子项2");
            paragraph.ListFormat.ApplyStyle("bulltedStyle");
            paragraph.ListFormat.ListLevelNumber = 2;

            paragraph = section.AddParagraph();
            paragraph.AppendText("第二项");
            paragraph.ListFormat.ApplyStyle("numberedStyle");
            paragraph.ListFormat.ListLevelNumber = 0;

            //保存结果文档
            document.SaveToFile("多级混合类型列表.docx", FileFormat.Docx);
        }
    }
}

Imports Spire.Doc
Imports Spire.Doc.Documents

Namespace CreateMultilevelMixedList
    Friend Class Program
        Private Shared Sub Main(ByVal args As String())
            '创建一个Document对象
            Dim document As Document = New Document()

            '添加一个节
            Dim section As Section = document.AddSection()

            '创建编号列表样式
            Dim numberedListStyle As ListStyle = New ListStyle(document, ListType.Numbered)
            numberedListStyle.Name = "numberedStyle"
            numberedListStyle.Levels(0).PatternType = ListPatternType.Arabic
            numberedListStyle.Levels(0).TextPosition = 20
            numberedListStyle.Levels(1).PatternType = ListPatternType.LowLetter
            document.ListStyles.Add(numberedListStyle)

            '创建项目符号列表样式
            Dim bulletedListStyle As ListStyle = New ListStyle(document, ListType.Bulleted)
            bulletedListStyle.Name = "bulltedStyle"
            bulletedListStyle.Levels(2).BulletCharacter = "*"
            bulletedListStyle.Levels(2).CharacterFormat.FontName = "Symbol"
            document.ListStyles.Add(bulletedListStyle)

            '添加段落
            Dim paragraph As Paragraph = section.AddParagraph()
            paragraph.AppendText("这是一个多级混合列表:")
            paragraph.Format.AfterSpacing = 5F

            '添加段落并对其应用编号列表样式
            paragraph = section.AddParagraph()
            paragraph.AppendText("第一项")
            paragraph.ListFormat.ApplyStyle("numberedStyle")
            paragraph.ListFormat.ListLevelNumber = 0

            '再添加五个段落，并对其应用不同的列表样式
            paragraph = section.AddParagraph()
            paragraph.AppendText("第一个子项")
            paragraph.ListFormat.ApplyStyle("numberedStyle")
            paragraph.ListFormat.ListLevelNumber = 1

            paragraph = section.AddParagraph()
            paragraph.AppendText("第二个子项")
            paragraph.ListFormat.ListLevelNumber = 1
            paragraph.ListFormat.ApplyStyle("numberedStyle")

            paragraph = section.AddParagraph()
            paragraph.AppendText("子项1")
            paragraph.ListFormat.ApplyStyle("bulltedStyle")
            paragraph.ListFormat.ListLevelNumber = 2

            paragraph = section.AddParagraph()
            paragraph.AppendText("子项2")
            paragraph.ListFormat.ApplyStyle("bulltedStyle")
            paragraph.ListFormat.ListLevelNumber = 2

            paragraph = section.AddParagraph()
            paragraph.AppendText("第二项")
            paragraph.ListFormat.ApplyStyle("numberedStyle")
            paragraph.ListFormat.ListLevelNumber = 0

            '保存结果文档
            document.SaveToFile("多级混合类型列表.docx", FileFormat.Docx)
        End Sub
    End Class
End Namespace

C#/VB.NET 在 Word 文档中插入列表

申请临时 License

如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。