C# コードで Word にリストを挿入する方法

## はじめに
Word文書を編集する際には、番号付きリストと箇条書きリストを挿入して情報をより良く整理し、表示することができます。番号付きリストは、特定の順にコンテンツを並べます。一方、箇条書きリストでは、コンテンツに特定の順序はなく、各アイテムの前には記号やマークがあります。これらのリストを使用することで、著者は特定の情報を強調し、読者が文書の内容をより良く読むのを助けることができます。
## ツール
* Visual Studio 2022 
* [Free Spire.Doc for .NET](https://www.e-iceblue.com/Introduce/free-doc-component.html)

これは[Spire.Doc for .NET](https://www.e-iceblue.com/Introduce/word-for-net-introduce.html)の無料版製品です。直接ダウンロードして使用することができます。
## 準備
1. [Free Spire.Doc for .NET](https://www.e-iceblue.com/Download/download-word-for-net-free.html)をダウンロードします。
2. Visual Studioで新しいプロジェクトを作成します。
3. そのプロジェクトを開いた後、「Solution Explorer」>「References」>「Add Reference」>「Browse」を選択します。
4. BINフォルダ内のDLLファイルを見つけて、「OK」をクリックします。

上記の手順で DLL ファイルをプロジェクトに簡単にインポートできます。
## コード：
### 番号付きリストの挿入
```C#:
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("日本の都市：");
            paragraph.Format.AfterSpacing = 5f;

            //段落を追加し、番号付きリスト スタイルを適用する
            paragraph = section.AddParagraph();
            paragraph.AppendText("東京");
            paragraph.ListFormat.ApplyStyle("numberedList");
            paragraph.ListFormat.ListLevelNumber = 0;

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

            paragraph = section.AddParagraph();
            paragraph.AppendText("名古屋");
            paragraph.ListFormat.ApplyStyle("numberedList");
            paragraph.ListFormat.ListLevelNumber = 0;

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

            //ファイルの保存
            document.SaveToFile("番号付きリスト.docx", FileFormat.Docx);
        }
    }
}
```
上記のコードのように、Word文書に番号付きリストを挿入するには、ListStyleクラスを使用して番号付きリストのスタイルを作成します。そして、Paragraph.ListFormat.ApplyStyle()メソッドを使用して、このスタイルを指定した段落に適用します。

以下は、生成された文書のスクリーンショット
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2811193/a0ad7bfa-415c-d6e5-1f43-5102d578f4f1.png)
### 箇条書きリストの挿入
```C#:
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;

            //ファイルの保存
            document.SaveToFile("箇条書き.docx", FileFormat.Docx);
        }
    }
}
```
箇条書きリストを作成するプロセスは、番号付きリストを作成するプロセスと似ています。しかし、リストスタイルを作成する際に、リストタイプを「Bulleted」に設定し、項目の記号を設定する必要があることです。

以下は、生成された文書のスクリーンショット
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2811193/fc7c741c-a693-d9ef-b4e3-93edab0e5fd0.png)