Formato set di proprietà serializzati di archiviazione strutturata

I set di proprietà persistenti offrono un'opzione per archiviare i dati all'interno delle entità del file system. È consigliabile creare e gestirli, usare le interfacce IPropertySetStorage e IPropertyStorage descritte in Proprietà e set di proprietà.

I set di proprietà sono costituiti da una sezione con tag di valori, con la sezione identificata in modo univoco da un identificatore di formato (FMTID). Ogni proprietà è costituita da un identificatore di proprietà e da un indicatore di tipo che rappresenta un valore. Ogni valore archiviato in un set di proprietà ha un identificatore di proprietà univoco che distingue la proprietà. L'indicatore di tipo descrive la rappresentazione dei dati nel valore.

Quando si usano le interfacce IPropertySetStorage e IPropertyStorage , non è necessario gestire la struttura di formato set di proprietà serializzata COM. Per altre informazioni, vedere gli argomenti elencati:

Tutti gli elementi di dati all'interno di un set di proprietà vengono archiviati nella rappresentazione Intel, ovvero in ordine di byte little-endian.

COM definisce un formato di dati standard e serializzato per i set di proprietà. Quando si gestisce il formato serializzato e non con le interfacce, i set di proprietà presentano le caratteristiche seguenti:

• I set di proprietà consentono alle diverse applicazioni di creare set di proprietà indipendenti per servire l'applicazione.
• I set di proprietà possono essere archiviati in una singola istanza IStream o in un'istanza di IStorage contenente più flussi. I set di proprietà sono semplicemente un altro tipo di dati che può essere archiviato in molte forme diverse di un'archiviazione in memoria o su disco. Per altre informazioni e convenzioni consigliate per la creazione del nome stringa per l'oggetto di archiviazione, vedere Convenzioni di denominazione degli oggetti di archiviazione.
• I set di proprietà consentono di includere un dizionario di nomi visualizzati che descrivono il contenuto. È consigliabile scegliere un set di convenzioni per la scelta dei nomi delle proprietà. Per altre informazioni su questo dizionario facoltativo, vedere Identificatori di proprietà riservati, inclusi ID proprietà 0.

Il flusso del set di proprietà è diviso in tre parti principali:

• Intestazione
• Coppia FORMATOD/offset
• Sezione contenente i valori effettivi del set di proprietà

La lunghezza complessiva del flusso del set di proprietà deve essere minore o uguale a 256K. Le sezioni seguenti, Intestazione set di proprietà, identificatore formato/coppia di offset e sezione (inclusi identificatori di proprietà/coppie offset), con argomenti di supporto, descrivono i singoli componenti che compongono il formato di dati del set di proprietà.

Nota

Le versioni precedenti di questo documento descrivono le estensioni al flusso del set di proprietà con più sezioni consentite, ma che sono state modificate per fornire una sezione nel flusso di proprietà. L'unica eccezione è Il set di proprietà DocumentSummaryInformation e UserDefined.