カスタム XML パーツにマップされたテーブル繰り返しセクションの作成

導入

このチュートリアルでは、Aspose.Words for .NET を使用して、カスタム XML パーツにマップされた繰り返しセクションを含むテーブルを作成するプロセスについて説明します。これは、構造化データに基づいてドキュメントを動的に生成する場合に特に便利です。

前提条件

始める前に、以下のものを用意してください。

Aspose.Words for .NETライブラリがインストールされています。Aspose ウェブサイト.
C# と XML の基本的な理解。

名前空間のインポート

プロジェクトに必要な名前空間を必ず含めてください。

using Aspose.Words;
using Aspose.Words.Markup;
using Aspose.Words.Tables;

ステップ 1: Document と DocumentBuilder を初期化する

まず、新しいドキュメントを作成し、DocumentBuilder:

string dataDir = "YOUR DOCUMENT DIRECTORY";

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

ステップ2: カスタムXMLパーツを追加する

ドキュメントにカスタム XML パーツを追加します。この XML には、テーブルにマップするデータが含まれています。

CustomXmlPart xmlPart = doc.CustomXmlParts.Add("Books",
    "<books><book><title>Everyday Italian</title><author>Giada De Laurentiis</author></book>" +
    "<book><title>Harry Potter</title><author>J K. Rowling</author></book>" +
    "<book><title>Learning XML</title><author>Erik T. Ray</author></book></books>");

ステップ3: テーブル構造を作成する

次に、DocumentBuilderテーブルヘッダーを作成するには:

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("Title");
builder.InsertCell();
builder.Write("Author");
builder.EndRow();
builder.EndTable();

ステップ4: 繰り返しセクションを作成する

作成するStructuredDocumentTag(SDT) を繰り返しセクションに作成し、XML データにマップします。

StructuredDocumentTag repeatingSectionSdt = new StructuredDocumentTag(doc, SdtType.RepeatingSection, MarkupLevel.Row);
repeatingSectionSdt.XmlMapping.SetMapping(xmlPart, "/books[1]/book", "");
table.AppendChild(repeatingSectionSdt);

ステップ5: 繰り返しセクションアイテムを作成する

繰り返しセクションアイテムの SDT を作成し、それを繰り返しセクションに追加します。

StructuredDocumentTag repeatingSectionItemSdt = new StructuredDocumentTag(doc, SdtType.RepeatingSectionItem, MarkupLevel.Row);
repeatingSectionSdt.AppendChild(repeatingSectionItemSdt);
Row row = new Row(doc);
repeatingSectionItemSdt.AppendChild(row);

ステップ 6: XML データをテーブルセルにマップする

タイトルと著者の SDT を作成し、それらを XML データにマップして、行に追加します。

StructuredDocumentTag titleSdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Cell);
titleSdt.XmlMapping.SetMapping(xmlPart, "/books[1]/book[1]/title[1]", "");
row.AppendChild(titleSdt);

StructuredDocumentTag authorSdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Cell);
authorSdt.XmlMapping.SetMapping(xmlPart, "/books[1]/book[1]/author[1]", "");
row.AppendChild(authorSdt);

ステップ7: ドキュメントを保存する

最後に、ドキュメントを指定されたディレクトリに保存します。

doc.Save(dataDir + "WorkingWithSdt.CreatingTableRepeatingSectionMappedToCustomXmlPart.docx");

結論

これらの手順に従うことで、Aspose.Words for .NET を使用して、カスタム XML パーツにマップされた繰り返しセクションを含むテーブルを正常に作成できました。これにより、構造化データに基づく動的なコンテンツ生成が可能になり、ドキュメント作成がより柔軟かつ強力になります。

よくある質問

StructuredDocumentTag (SDT) とは何ですか?

SDT (コンテンツコントロールとも呼ばれます) は、構造化データを格納するために使用されるドキュメント内の境界付き領域です。

カスタム XML 部分で他のデータ型を使用できますか?

はい、カスタム XML パーツを任意のデータ型で構造化し、それに応じてマップすることができます。

繰り返しセクションに行を追加するにはどうすればよいですか?

繰り返しセクションは、マップされた XML パス内の各項目の行構造を自動的に複製します。