Verwalten von Tags und benutzerdefinierten Daten in Präsentationen in .NET

Speicherung von Daten in Präsentationsdateien

PPTX‑Dateien – Elemente mit der Erweiterung .pptx – werden im PresentationML‑Format gespeichert, das Teil der Office‑Open‑XML‑Spezifikation ist. Das Office‑Open‑XML‑Format definiert die Struktur für in Präsentationen enthaltene Daten.

Da eine Folie eines der Elemente in Präsentationen ist, enthält ein Folien‑Teil den Inhalt einer einzelnen Folie. Ein Folien‑Teil kann explizite Beziehungen zu vielen Teilen haben – wie z. B. benutzerdefinierten Tags – die nach ISO/IEC 29500 definiert sind.

Benutzerdefinierte Daten (spezifisch für eine Präsentation) können als Tags (ITagCollection) und CustomXmlParts (ICustomXmlPartCollection) vorliegen.

Tags sind im Wesentlichen Schlüssel‑Wert‑Paare als Zeichenketten.

Werte von Tags abrufen

In Folien entspricht ein Tag der Eigenschaft IDocumentProperties.Keywords. Dieser Beispielcode zeigt, wie Sie den Wert eines Tags mit Aspose.Slides für .NET für Presentation abrufen:

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

Tags zu Präsentationen hinzufügen

Aspose.Slides ermöglicht das Hinzufügen von Tags zu Präsentationen. Ein Tag besteht typischerweise aus zwei Elementen:

• der Name einer benutzerdefinierten Eigenschaft – MyTag
• der Wert der benutzerdefinierten Eigenschaft – My Tag Value

Wenn Sie einige Präsentationen anhand einer bestimmten Regel oder Eigenschaft klassifizieren müssen, können Sie davon profitieren, Tags zu diesen Präsentationen hinzuzufügen. Beispielsweise können Sie, wenn Sie alle Präsentationen aus nordamerikanischen Ländern zusammenfassen möchten, ein nordamerikanisches Tag erstellen und dann die entsprechenden Länder (USA, Mexiko und Kanada) als Werte zuweisen.

Dieser Beispielcode zeigt, wie Sie ein Tag zu einer Presentation mit Aspose.Slides für .NET hinzufügen:

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

Tags können auch für Slide gesetzt werden:

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

Oder für jede einzelne 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";
}

FAQ

Kann ich alle Tags aus einer Präsentation, Folie oder Form in einem Vorgang entfernen?

Ja. Die tag collection unterstützt die clear‑Operation, die alle Schlüssel‑Wert‑Paare auf einmal löscht.

Wie lösche ich ein einzelnes Tag anhand seines Namens, ohne die gesamte Sammlung zu iterieren?

Verwenden Sie die Remove(name)‑Operation auf TagCollection, um das Tag anhand seines Schlüssels zu löschen.

Wie kann ich die vollständige Liste der Tag‑Namen für Analysen oder Filterung abrufen?

Verwenden Sie GetNamesOfTags auf der tag collection; sie gibt ein Array aller Tag‑Namen zurück.