Mengelola Properti Presentasi di .NET

Pendahuluan

Aspose.Slides for .NET mendukung properti dokumen built-in dan custom. Gunakan properti ini untuk membaca dan memperbarui metadata presentasi, seperti penulis, judul, dan nilai yang ditentukan pengguna.

Aspose.Slides memungkinkan Anda bekerja dengan properti dokumen presentasi melalui antarmuka IDocumentProperties . Sebuah instance dari antarmuka ini dikembalikan oleh IPresentation.DocumentProperties. Contoh-contoh berikut menunjukkan cara membaca, memodifikasi, dan mengelola properti tersebut.

Kelola Properti Presentasi

Properti dokumen menyimpan informasi deskriptif bersamaan dengan konten presentasi. Mereka terbagi menjadi dua kategori:

  • Built-in properties berisi metadata standar, seperti judul, penulis, dan statistik dokumen.
  • Custom properties menyimpan pasangan nama/nilai yang ditentukan pengguna.

Aspose.Slides for .NET menyediakan akses ke kedua kategori. Di PowerPoint, pilih File → Info → Properties → Advanced Properties untuk memeriksa metadata dokumen. Dialog tersebut mengelompokkan informasi ke dalam tab seperti Summary, Statistics, Contents, dan Custom. Gunakan tab Custom untuk mengelola properti yang ditentukan pengguna.

Baca Properti Publik dari Presentasi yang Terenkripsi

Password pembuka biasanya melindungi baik konten presentasi maupun properti dokumen. Ketika sebuah presentasi dienkripsi dengan IProtectionManager.EncryptDocumentProperties diatur ke false, properti dokumennya tetap publik. Sebuah aplikasi kemudian dapat mengatur LoadOptions.OnlyLoadDocumentProperties ke true dan membaca metadata publik tanpa menyediakan password pembuka.

LoadOptions.OnlyLoadDocumentProperties mengontrol apa yang dimuat oleh Aspose.Slides; ia tidak mendekripsi apa pun. Jika properti termasuk dalam enkripsi, memuatnya tanpa password akan gagal. Jika presentasi tidak dienkripsi, opsi ini diabaikan dan seluruh presentasi dimuat.

Contoh ini memerlukan presentasi terenkripsi di mana properti dokumennya dibiarkan publik. Ia memverifikasi mode pemuatan melalui IProtectionManager.IsOnlyDocumentPropertiesLoaded dan kemudian membaca properti built-in melalui IPresentation.DocumentProperties:

using System;
using Aspose.Slides;

var loadOptions = new LoadOptions { OnlyLoadDocumentProperties = true };
using var presentation = new Presentation("public-properties-encrypted.pptx", loadOptions);

if (presentation.ProtectionManager.IsOnlyDocumentPropertiesLoaded)
{
    var documentProperties = presentation.DocumentProperties;

    Console.WriteLine("Author: " + documentProperties.Author);
    Console.WriteLine("Title: " + documentProperties.Title);
    Console.WriteLine("Keywords: " + documentProperties.Keywords);
}
else
{
    Console.WriteLine("The presentation was not loaded in document-properties-only mode.");
}

Dalam mode ini, konten slide tidak dimuat. Slide, master, layout, shape, media, dan objek presentasi lainnya tidak tersedia. Aplikasi harus selalu memeriksa IProtectionManager.IsOnlyDocumentPropertiesLoaded sebelum melakukan operasi yang memerlukan model objek presentasi lengkap.

Perbarui Properti Presentasi yang Terenkripsi

Untuk file PPTX yang terenkripsi, presentasi yang dimuat dengan LoadOptions.OnlyLoadDocumentProperties ditujukan untuk membaca metadata publik. Aspose.Slides tidak dapat menyimpan properti yang berubah dari objek hanya-metadata tersebut karena properti publik harus tetap konsisten dengan data yang bersesuaian di dalam presentasi terenkripsi. Oleh karena itu, memperbarui properti memerlukan password pembuka yang benar dan pemuatan lengkap.

Contoh ini memerlukan presentasi PPTX terenkripsi dengan properti dokumen publik dan password pembuka yang diketahui. Ia membuka presentasi lengkap dengan LoadOptions.Password, memperbarui properti built-in publik, dan menyimpan hasilnya. Kemudian ia menggunakan IPresentationInfo.IsEncrypted untuk memverifikasi bahwa enkripsi tetap terjaga dan membuka kembali metadata publik tanpa password untuk memverifikasi nilai baru:

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

const string inputPath = "public-properties-encrypted.pptx";
const string outputPath = "updated-public-properties-encrypted.pptx";

var loadOptions = new LoadOptions { Password = "open_password" };
using var presentation = new Presentation(inputPath, loadOptions);

var documentProperties = presentation.DocumentProperties;
documentProperties.Title = "Updated Product Roadmap";
documentProperties.Keywords = "roadmap, planning, indexed";

presentation.Save(outputPath, SaveFormat.Pptx);

var presentationInfo = PresentationFactory.Instance.GetPresentationInfo(outputPath);
Console.WriteLine("The presentation is encrypted: " + presentationInfo.IsEncrypted);

var metadataLoadOptions = new LoadOptions { OnlyLoadDocumentProperties = true };
using var metadataPresentation = new Presentation(outputPath, metadataLoadOptions);

if (metadataPresentation.ProtectionManager.IsOnlyDocumentPropertiesLoaded)
{
    Console.WriteLine("Title: " + metadataPresentation.DocumentProperties.Title);
    Console.WriteLine("Keywords: " + metadataPresentation.DocumentProperties.Keywords);
}
else
{
    Console.WriteLine("The presentation was not loaded in document-properties-only mode.");
}

Jika sebuah aplikasi tidak diizinkan untuk mendekripsi atau memuat konten presentasi, ia harus memperlakukan properti publik dari file PPTX terenkripsi sebagai read‑only.

Akses Properti Built-in

Antarmuka IDocumentProperties mengekspose metadata built-in melalui properti bertipe, termasuk Author, Title, dan CreatedTime. Contoh ini membuka presentasi yang ada dan mencetak metadata yang disimpan ke konsol. Nilai tergantung pada presentasi masukan; beberapa bidang mungkin kosong.

using System;
using Aspose.Slides;

using var presentation = new Presentation("AccessBuiltInProperties.pptx");

var documentProperties = presentation.DocumentProperties;

Console.WriteLine("Category: " + documentProperties.Category);
Console.WriteLine("Content status: " + documentProperties.ContentStatus);
Console.WriteLine("Creation date: " + documentProperties.CreatedTime);
Console.WriteLine("Author: " + documentProperties.Author);
Console.WriteLine("Comments: " + documentProperties.Comments);
Console.WriteLine("Keywords: " + documentProperties.Keywords);
Console.WriteLine("Last modified by: " + documentProperties.LastSavedBy);
Console.WriteLine("Manager: " + documentProperties.Manager);
Console.WriteLine("Modified date: " + documentProperties.LastSavedTime);
Console.WriteLine("Presentation format: " + documentProperties.PresentationFormat);
Console.WriteLine("Last print date: " + documentProperties.LastPrinted);
Console.WriteLine("Is shared between producers: " + documentProperties.SharedDoc);
Console.WriteLine("Subject: " + documentProperties.Subject);
Console.WriteLine("Title: " + documentProperties.Title);

Modifikasi Properti Built-in

Untuk memperbarui metadata built-in, tetapkan nilai ke properti yang dapat ditulisi yang diekspos oleh IPresentation.DocumentProperties. Contoh ini membuka presentasi yang ada, mengatur Author, Title, Subject, Comments, dan Manager, kemudian menyimpan presentasi yang diperbarui dengan Presentation.Save. PPTX yang disimpan berisi metadata baru.

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("ModifyBuiltInProperties.pptx");

var documentProperties = presentation.DocumentProperties;

documentProperties.Author = "Aspose.Slides for .NET";
documentProperties.Title = "Manage PowerPoint Presentation Properties";
documentProperties.Subject = "Modify Built-in Properties";
documentProperties.Comments = "Aspose description";
documentProperties.Manager = "Aspose manager";

presentation.Save("DocumentProperties_output.pptx", SaveFormat.Pptx);

IDocumentProperties.HyperlinkBase menyimpan basis dokumen untuk hyperlink relatif. Ini berguna saat memindahkan presentasi dan file terkait ke lokasi lain. Ini terpisah dari IHyperlink.ExternalUrl pada hyperlink individual: mengubah basis tidak menulis ulang alamat tautan yang disimpan atau mengubah tujuan absolut.

Contoh ini memerlukan presentasi yang berisi tautan relatif, misalnya target.html, dan tautan absolut, misalnya https://example.org/absolute.html. Ia membaca basis yang ada, menetapkan alamat basis baru, dan menyimpan serta membuka kembali presentasi untuk memeriksa nilai tersebut. Kemudian ia mengosongkan basis dengan string.Empty dan memverifikasi nilai kosong dalam file tersimpan terpisah. Ganti alamat basis contoh dengan lokasi file tautan Anda.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("hyperlinks.pptx");
Console.WriteLine("Original base: " + presentation.DocumentProperties.HyperlinkBase);

const string newBase = "https://example.com/new/";
presentation.DocumentProperties.HyperlinkBase = newBase;
presentation.Save("hyperlinks-updated.pptx", SaveFormat.Pptx);

using var updatedPresentation = new Presentation("hyperlinks-updated.pptx");
Console.WriteLine("Base preserved: " + (updatedPresentation.DocumentProperties.HyperlinkBase == newBase));

updatedPresentation.DocumentProperties.HyperlinkBase = string.Empty;
updatedPresentation.Save("hyperlinks-cleared.pptx", SaveFormat.Pptx);

using var clearedPresentation = new Presentation("hyperlinks-cleared.pptx");
Console.WriteLine("Base cleared: " + (clearedPresentation.DocumentProperties.HyperlinkBase == string.Empty));

Kedua pesan verifikasi harus mencetak True. Mengosongkan basis tidak mempengaruhi alamat hyperlink individual.

Tautan relatif ke target.pptx membuka old/target.pptx ketika basis menunjuk ke folder old. Setelah mengubah basis ke folder new, menyimpan, dan membuka kembali presentasi, tautan yang sama membuka new/target.pptx. Tautan absolut tetap membuka file yang sama. Uji tautan relatif Anda di PowerPoint sebelum dan sesudah memindahkan presentasi atau mengubah basisnya.

Tambahkan Properti Presentasi Kustom

Properti kustom menyimpan metadata yang tidak memiliki bidang built-in yang bersesuaian. IDocumentProperties indexer memungkinkan Anda menetapkan nilai berdasarkan nama properti. Contoh ini membuat presentasi, menambahkan dua nilai teks dan satu nilai versi integer, serta menyimpan presentasi dengan Presentation.Save. Menetapkan nilai ke nama yang sudah ada menggantikan nilai properti tersebut.

using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation();

var documentProperties = presentation.DocumentProperties;

documentProperties["Reviewed by"] = "John Smith";
documentProperties["Confidentiality level"] = "Internal";
documentProperties["Document version"] = 2;

presentation.Save("CustomDocumentProperties_output.pptx", SaveFormat.Pptx);

Akses dan Modifikasi Properti Kustom

Contoh ini membuka presentasi yang berisi properti kustom dan menggunakan CountOfCustomProperties untuk mengiterasi mereka. GetCustomPropertyName menerima indeks berbasis nol dan mengembalikan nama yang digunakan oleh IDocumentProperties indexer. Contoh ini mencetak masing‑masing nama dan nilai asli, mengganti setiap nilai dengan string bernomor terlepas dari tipe asalnya, dan menyimpan perubahan. Jika tidak ada properti kustom, loop tidak melakukan perubahan.

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

using var presentation = new Presentation("AccessAndModifyProperties.pptx");

var documentProperties = presentation.DocumentProperties;

for (var i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
    var propertyName = documentProperties.GetCustomPropertyName(i);
    var propertyValue = documentProperties[propertyName];

    Console.WriteLine("Custom property name: " + propertyName);
    Console.WriteLine("Custom property value: " + propertyValue);

    documentProperties[propertyName] = "New Value " + (i + 1);
}

presentation.Save("CustomProperties_output.pptx", SaveFormat.Pptx);

Contoh Langsung

Coba aplikasi online View & Edit PowerPoint Metadata untuk melihat cara bekerja dengan properti dokumen menggunakan API Aspose.Slides:

View & Edit PowerPoint Metadata

FAQ

Bagaimana saya dapat menghapus properti built-in dari presentasi?

Properti built-in merupakan bagian integral dari presentasi dan tidak dapat dihapus sepenuhnya. Namun, Anda dapat mengubah nilainya atau mengosongkannya jika properti tersebut mengizinkan.

Apa yang terjadi jika saya menambahkan properti kustom yang sudah ada?

Jika Anda menambahkan properti kustom yang sudah ada, nilai yang ada akan ditimpa dengan nilai baru. Anda tidak perlu menghapus atau memeriksa properti tersebut terlebih dahulu, karena Aspose.Slides secara otomatis memperbarui nilai properti.

Bisakah saya mengakses properti presentasi tanpa memuat seluruh presentasi?

Ya. Gunakan PresentationFactory.GetPresentationInfo lalu IPresentationInfo.ReadDocumentProperties untuk membaca metadata dokumen yang disimpan tanpa membuat instance Presentation. Lihat Build a Lightweight Presentation Inventory untuk contoh pelaporan lengkap dan keterbatasan spesifik format.

Bisakah saya membaca properti publik dari presentasi yang terenkripsi tanpa password pembukanya?

Ya. Presentasi harus dienkripsi dengan IProtectionManager.EncryptDocumentProperties yang diatur ke false, dan harus dimuat dengan LoadOptions.OnlyLoadDocumentProperties yang diatur ke true.

Bisakah saya memperbarui file PPTX terenkripsi dalam mode hanya‑properti‑dokumen?

Tidak. Data properti publik dan terenkripsi harus tetap konsisten, sehingga memperbarui file PPTX terenkripsi memerlukan pemuatan lengkap presentasi dengan password pembuka yang benar.