タグとカスタムデータの管理

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

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

スライドはプレゼンテーションの要素の1つであり、スライドパートは1つのスライドの内容を含んでいます。スライドパートは、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

特定のルールやプロパティに基づいていくつかのプレゼンテーションを分類する必要がある場合は、それらのプレゼンテーションにタグを追加することでメリットを得ることができます。たとえば、北米の国々からのすべてのプレゼンテーションをカテゴリ化またはまとめたい場合は、北米タグを作成し、関連する国(アメリカ、メキシコ、カナダ)を値として割り当てることができます。

このサンプルコードは、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";
}