Bagikan melalui

Mengelola Set Properti

  • Artikel

Kumpulan properti persisten berisi data terkait sebagai properti. Setiap set properti diidentifikasi dengan FMTID, dan pengidentifikasi unik global (GUID) yang memungkinkan aplikasi, mengakses kumpulan properti, untuk mengidentifikasi kumpulan properti. Melalui identifikasi ini, aplikasi menginterpretasikan properti yang dikandung set.

Misalnya, properti pemformatan karakter dalam prosesor kata atau atribut penyajian elemen dalam program gambar adalah kumpulan properti.

COM mendefinisikan antarmuka IPropertySetStorage untuk memfasilitasi manajemen set properti. Melalui metode antarmuka ini, Anda dapat membuat kumpulan properti baru, atau membuka atau menghapus kumpulan properti yang ada. Selain itu, ia menyediakan metode yang membuat enumerator dan memasok pointer ke antarmuka IEnumSTATPROPSETSTG-nya . Anda dapat memanggil metode antarmuka ini untuk menghitung struktur STATPROPSETSTG pada objek Anda, yang akan memberikan informasi tentang semua set properti pada objek.

Saat Anda membuat atau membuka instans IPropertyStorage, ini mirip dengan membuka objek yang mendukung IStorage atau IStream, karena Anda perlu menentukan mode penyimpanan tempat Anda membuka antarmuka. Untuk IStorage, ini termasuk mode transaksi, mode baca/tulis, dan mode berbagi.

Saat Anda membuat properti yang diatur dengan panggilan ke IPropertySetStorage::Create, tentukan apakah kumpulan properti menjadi sederhana atau tidak. Set properti sederhana berisi jenis yang dapat ditulis sepenuhnya dalam aliran set properti, yang dimaksudkan untuk dibatasi ukurannya, dan tidak boleh lebih besar dari 256 KB di Windows NT 4.0 dan yang lebih lama, atau 1 MB di Windows 2000, Windows XP, dan Windows Server 2003. Namun, ketika Anda perlu menyimpan sejumlah besar informasi dalam kumpulan properti, Anda dapat menentukan bahwa set properti menjadi nonsimple. Ini memungkinkan Anda menggunakan satu atau beberapa jenis yang hanya menentukan penunjuk ke penyimpanan atau objek streaming. Jenis-jenis ini VT_STREAM, VT_STREAMED OBJECT, VT_STORAGE, dan VT_STORED_OBJECT.

Data yang disimpan dalam properti ini tidak dihitung terhadap batas ukuran set properti 256 KB di Windows NT 4.0 atau yang lebih lama, atau batas 1 MB di Windows 2000, Windows XP, dan Windows Server 2003. Namun, data tentang properti, seperti namanya, memang berlaku. Selain itu, jika Anda memerlukan pembaruan yang ditransaksikan, kumpulan properti harus nonsimple. Tentu saja ada penalti performa tertentu untuk membuka jenis ini, karena memerlukan pembukaan aliran atau objek penyimpanan tempat Anda memiliki penunjuk.

Jika aplikasi Anda menggunakan file campuran, Anda dapat menggunakan implementasi yang disediakan COM dari antarmuka ini, yang diimplementasikan pada objek penyimpanan file gabungan.

Setiap set properti terutama terdiri dari sekelompok properti yang terhubung secara logis, seperti yang dijelaskan dalam Mengelola Properti.

Untuk informasi selengkapnya tentang kumpulan properti di COM, lihat: