Zarządzanie tagami i danymi niestandardowymi w prezentacjach w .NET

Przegląd

Ten artykuł wyjaśnia, jak Aspose.Slides obsługuje tagi i dane niestandardowe w prezentacjach PowerPoint. Krótko opisuje, w jaki sposób dane są przechowywane w plikach PPTX, zauważa, że dane specyficzne dla prezentacji mogą istnieć jako tagi i niestandardowe części XML, oraz opisuje tagi jako pary klucz‑wartość w postaci ciągów znaków.

Pokazuje także, jak odczytywać wartości tagów oraz jak dodawać tagi do prezentacji, pojedynczego slajdu lub kształtu. Dodatkowo artykuł omawia typowe zadania zarządzania tagami, takie jak usuwanie wszystkich tagów, usuwanie tagu po nazwie oraz pobieranie listy nazw tagów.

Przechowywanie danych w plikach prezentacji

Pliki PPTX — elementy z rozszerzeniem .pptx — są przechowywane w formacie PresentationML, który jest częścią specyfikacji Office Open XML. Format Office Open XML definiuje strukturę danych zawartych w prezentacjach.

Slide jest jednym z elementów prezentacji, a slide part zawiera zawartość pojedynczego slajdu. Slide part może mieć jawne powiązania z wieloma częściami — na przykład z User Defined Tags — zgodnie z ISO/IEC 29500.

Dane niestandardowe (specyficzne dla prezentacji) lub użytkownika mogą istnieć jako tagi (ITagCollection) i części CustomXml (ICustomXmlPartCollection).

Tagi są zasadniczo parami klucz‑wartość typu string.

Pobieranie wartości tagów

W Slides tag odpowiada właściwości IDocumentProperties.Keywords. Poniższy przykładowy kod pokazuje, jak uzyskać wartość tagu przy użyciu Aspose.Slides for .NET dla Presentation:

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

Dodawanie tagów do prezentacji

Aspose.Slides umożliwia dodawanie tagów do prezentacji. Tag zazwyczaj składa się z dwóch elementów:

nazwa własności niestandardowej — MyTag
wartość własności niestandardowej — My Tag Value

Jeśli potrzebujesz klasyfikować niektóre prezentacje według określonej reguły lub własności, możesz skorzystać z dodawania tagów do tych prezentacji. Na przykład, jeżeli chcesz pogrupować wszystkie prezentacje z krajów Ameryki Północnej, możesz utworzyć tag „North American” i przypisać odpowiednie kraje (USA, Meksyk, Kanada) jako wartości.

Poniższy kod pokazuje, jak dodać tag do Presentation przy użyciu Aspose.Slides for .NET:

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

Tagi można również ustawić dla Slide:

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

Lub dowolnego pojedynczego 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";
}

Ograniczenia

Tagi dodane przy użyciu kolekcji CustomData.Tags są przechowywane wyłącznie w pliku PowerPoint. Nie są przenoszone do struktury tagów PDF podczas eksportu prezentacji do PDF. W konsekwencji identyfikator niestandardowy przypisany jako tag nie może zostać odczytany z otagowanego pliku PDF.

Obejście: możesz przechowywać identyfikator niestandardowy w Alt Text obiektu (np. shape.AlternativeText = "MyId"). Po eksporcie do PDF tekst alternatywny może pojawić się w strukturze tagów PDF.

FAQ

Czy mogę usunąć wszystkie tagi z prezentacji, slajdu lub kształtu w jednej operacji?

Tak. tag collection obsługuje operację clear, która usuwa wszystkie pary klucz‑wartość jednocześnie.

Jak usunąć pojedynczy tag po nazwie bez iteracji po całej kolekcji?

Użyj operacji Remove(name) na TagCollection, aby usunąć tag po jego kluczu.

Jak mogę pobrać pełną listę nazw tagów w celu analizy lub filtrowania?

Użyj GetNamesOfTags na tag collection; zwraca ona tablicę wszystkich nazw tagów.

Tworzenie i dostosowywanie tabel PowerPoint w .NET