カスタム XML マークアップを .NET で扱う方法

ステップ 1: 文書からカスタム XML データを読み取る

Document.CustomXmlParts は CustomXmlPartCollection を返します — これは Word が XML にマップされたコンテンツ コントロールをサポートする際に使用するのと同じメカニズムです。コレクションを反復処理するか、必要なパーツが既に分かっている場合は GetById(id) を呼び出して CustomXmlPart を取得します。各パーツは Id を公開し、これは生の XML を保持する Data バイト配列、完全なバイト比較を行わずにデータの変更を検出するための DataChecksum、そして Schemas — それに関連付けられた XML スキーマを列挙する CustomXmlSchemaCollection です。

ステップ 2: カスタム XML パーツを追加または更新する

id文字列とXMLコンテンツを使用してCustomXmlPartCollection.Add(id, xml)を呼び出し、直接パートを作成するか、CustomXmlPartを別途構築してAdd(part)に渡します。データを削除するには、特定の位置でRemoveAt(index)を使用するか、すべてのパートを削除するためにClear()を使用します。ドキュメント間でカスタムXMLデータをコピーする場合、元のパートでCustomXmlPart.Clone()（またはコレクションのClone()）を使用し、生のXMLを再読み取りして再追加するのではなく、クローンをターゲットドキュメントのDocument.CustomXmlPartsに追加します。

ステップ3：パートに関連付けられたスキーマを管理する

CustomXmlPart.SchemasはCustomXmlSchemaCollectionに到達し、パートに関連付けられたスキーマURIを解析されたスキーマオブジェクトではなくプレーンな文字列として追跡します。Add(value)を使用してスキーマURIを登録し、Remove(name)またはRemoveAt(index)で削除し、IndexOf(value)で検索し、Clear()ですべて削除します。Countは現在パートに関連付けられているスキーマURIの数を報告します。

ステップ4：パッケージレベルのカスタムパートを操作する

OOXMLパッケージ内のすべての非表示パートがカスタムXMLというわけではありません。Document.PackageCustomPartsはCustomPartオブジェクトのCustomPartCollectionを返します——ファイルに手を加えた別のアプリケーションが追加したパートなど、パッケージに格納された任意のパートです。各CustomPartはName、ContentType、RelationshipType、Dataバイト配列、そして埋め込みコンテンツではなく外部参照であるかを示すIsExternalフラグを持ちます。Add(part)、RemoveAt(index)、およびClear()はCustomXmlPartCollectionと同様の方法でコレクションを管理します。ドキュメントが保持すべきパートがカスタムXMLコレクションに表示されない場合は、PackageCustomParts（CustomXmlPartsではなく）を確認してください。

ステップ5：レガシー・スマートタグとそのプロパティを検査する

SmartTagは、認識されたテキストを囲むレガシーWordスマートタグを表すノード型（NodeType.SmartTag、SmartTag(doc)で構築）です。ElementとUriを併せて確認し、どのリコグナイザがタグを作成したかを特定し、次にProperties（CustomXmlPropertyCollection）を読み取り、リコグナイザが付与した構造化データを取得します。CustomXmlPropertyCollection内では、インデクサ（例：properties["MyProp"]）またはContains(name)が特定のプロパティを検索し、IndexOfKey(name)がその位置を返し、Remove(name)/RemoveAt(index)/Clear()がエントリを削除します；各CustomXmlPropertyはCustomXmlProperty(name, uri, value)で構築され、Name、Uri、Valueを公開します。SmartTagはCompositeNodeから派生しているため、他のノードと同様にドキュメントツリーに参加し、DocumentVisitorベースの走査のためにAccept(visitor)、AcceptStart(visitor)、AcceptEnd(visitor)をサポートします。