.NET のプレゼンテーションにおけるタグとカスタムデータの管理

プレゼンテーションファイルのデータストレージ

PPTX ファイル（拡張子 .pptx のアイテム）は、Office Open XML 仕様の一部である PresentationML 形式で保存されます。Office Open XML 形式は、プレゼンテーションに含まれるデータの構造を定義します。

スライド はプレゼンテーションの要素の一つで、スライド パート は単一スライドの内容を保持します。スライド パートは ISO/IEC 29500 で定義されたユーザー定義タグなど、多くのパートへの明示的なリレーションシップを持つことができます。

カスタム データ（プレゼンテーション固有）またはユーザーは、タグ（ITagCollection）および CustomXmlParts（ICustomXmlPartCollection）として存在できます。

タグは基本的に文字列キーと値のペアです。

タグの値を取得

スライドでは、タグは IDocumentProperties.Keywords プロパティに対応します。このサンプルコードは、Aspose.Slides for .NET の Presentation でタグの値を取得する方法を示しています：

using (Presentation pres = new Presentation("pres.pptx"))
{
   string keywords = pres.DocumentProperties.Keywords;
}

プレゼンテーションへのタグの追加

Aspose.Slides を使用すると、プレゼンテーションにタグを追加できます。タグは通常、次の 2 つの項目で構成されます：

• カスタム プロパティの名前 - MyTag
• カスタム プロパティの値 - My Tag Value

特定のルールやプロパティに基づいてプレゼンテーションを分類する必要がある場合、タグを追加すると便利です。例えば、北米諸国のプレゼンテーションをすべてまとめて分類したい場合、North American タグを作成し、該当する国（米国、メキシコ、カナダ）を値として割り当てることができます。

このサンプルコードは、Aspose.Slides for .NET を使用して Presentation にタグを追加する方法を示しています：

using (Presentation pres = new Presentation("pres.pptx"))
{
   ITagCollection tags = pres.CustomData.Tags;
   pres.CustomData.Tags["MyTag"] = "My Tag Value";
}

タグは Slide に対しても設定できます：

using(Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];
    slide.CustomData.Tags["tag"] = "value";
}

または個々の Shape に対しても設定できます：

using(Presentation pres = new Presentation())
{
    ISlide slide = pres.Slides[0];
    IAutoShape shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 100, 50);
    shape.TextFrame.Text = "My text";
    shape.CustomData.Tags["tag"] = "value";
}

よくある質問

プレゼンテーション、スライド、またはシェイプからすべてのタグを一括で削除できますか？

はい。tag collection は、すべてのキーと値のペアを一度に削除する clear 操作をサポートしています。

コレクション全体を反復処理せずに、名前で単一のタグを削除するにはどうすればよいですか？

TagCollection の Remove(name) 操作を使用して、キーでタグを削除します。

分析やフィルタリングのために、タグ名の完全なリストを取得するにはどうすればよいですか？

tag collection で GetNamesOfTags を使用します。これにより、すべてのタグ名を含む配列が返されます。