Kelola Tag dan Data Kustom dalam Presentasi di .NET
Gambaran Umum
Artikel ini menjelaskan cara Aspose.Slides bekerja dengan tag dan data khusus dalam presentasi PowerPoint. Artikel ini secara singkat menguraikan bagaimana data disimpan dalam file PPTX, mencatat bahwa data khusus presentasi dapat ada sebagai tag dan bagian XML khusus, serta menjelaskan tag sebagai pasangan string kunci‑nilai.
Artikel ini juga menunjukkan cara membaca nilai tag serta cara menambahkan tag ke presentasi, slide individu, atau shape. Selain itu, artikel ini membahas tugas umum pengelolaan tag seperti menghapus semua tag, menghapus tag berdasarkan nama, dan mengambil daftar nama tag.
Penyimpanan Data dalam File Presentasi
File PPTX—item dengan ekstensi .pptx—disimpan dalam format PresentationML, yang merupakan bagian dari spesifikasi Office Open XML. Format Office Open XML mendefinisikan struktur data yang terdapat dalam presentasi.
Dengan slide sebagai salah satu elemen dalam presentasi, sebuah slide part berisi konten satu slide. Sebuah slide part diizinkan memiliki hubungan eksplisit ke banyak bagian—seperti User Defined Tags—yang didefinisikan oleh ISO/IEC 29500.
Data khusus (spesifik untuk sebuah presentasi) atau data pengguna dapat ada sebagai tag (ITagCollection) dan CustomXmlParts (ICustomXmlPartCollection).
Dapatkan Nilai Tag
Dalam Slides, sebuah tag berkorespondensi dengan properti IDocumentProperties.Keywords. Kode contoh ini menunjukkan cara mendapatkan nilai tag dengan Aspose.Slides untuk .NET untuk Presentation:
using (Presentation pres = new Presentation("pres.pptx"))
{
string keywords = pres.DocumentProperties.Keywords;
}
Menambahkan Tag ke Presentasi
Aspose.Slides memungkinkan Anda menambahkan tag ke presentasi. Sebuah tag biasanya terdiri dari dua item:
- nama properti kustom -
MyTag - nilai properti kustom -
My Tag Value
Jika Anda perlu mengklasifikasikan beberapa presentasi berdasarkan aturan atau properti tertentu, maka Anda dapat memperoleh manfaat dari menambahkan tag ke presentasi tersebut. Misalnya, jika Anda ingin mengelompokkan semua presentasi dari negara‑negara Amerika Utara, Anda dapat membuat tag Amerika Utara dan kemudian menetapkan negara‑negara yang relevan (AS, Meksiko, dan Kanada) sebagai nilai.
Kode contoh ini menunjukkan cara menambahkan tag ke sebuah Presentation menggunakan Aspose.Slides untuk .NET:
using (Presentation pres = new Presentation("pres.pptx"))
{
ITagCollection tags = pres.CustomData.Tags;
pres.CustomData.Tags["MyTag"] = "My Tag Value";
}
Tag juga dapat diatur untuk Slide:
using(Presentation pres = new Presentation())
{
ISlide slide = pres.Slides[0];
slide.CustomData.Tags["tag"] = "value";
}
Atau shape individu mana pun 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";
}
Batasan
Tag yang ditambahkan melalui koleksi CustomData.Tags hanya disimpan di dalam file PowerPoint. Tag tersebut tidak dipindahkan ke struktur tag PDF ketika presentasi diekspor ke PDF. Akibatnya, pengidentifikasi khusus yang ditetapkan sebagai tag tidak dapat diambil dari PDF yang ber‑tag.
Workaround: Anda dapat menyimpan pengidentifikasi khusus dalam Alt Text objek (misalnya, shape.AlternativeText = "MyId"). Setelah diekspor ke PDF, Alt Text dapat muncul dalam struktur tag PDF.
FAQ
Apakah saya dapat menghapus semua tag dari sebuah presentasi, slide, atau shape dalam satu operasi?
Ya. tag collection mendukung operasi clear yang menghapus semua pasangan kunci‑nilai sekaligus.
Bagaimana cara menghapus satu tag berdasarkan namanya tanpa iterasi seluruh koleksi?
Gunakan operasi Remove(name) pada TagCollection untuk menghapus tag berdasarkan kuncinya.
Bagaimana cara mengambil daftar lengkap nama tag untuk analisis atau penyaringan?
Gunakan GetNamesOfTags pada tag collection; metode ini mengembalikan array semua nama tag.