Metodo ReplicaMetadata.CreateItemMetadata

Articolo
10/17/2009

Quando sottoposto a override in una classe derivata, crea un nuovo oggetto di metadati dell'elemento che può essere utilizzato per aggiungere una nuova voce di metadati dell'elemento all'archivio dei metadati.

Spazio dei nomi: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (in microsoft.synchronization.metadatastorage.dll)

Sintassi

'Dichiarazione
Public MustOverride Function CreateItemMetadata ( _
    globalId As SyncId, _
    creationVersion As SyncVersion _
) As ItemMetadata
'Utilizzo
Dim instance As ReplicaMetadata
Dim globalId As SyncId
Dim creationVersion As SyncVersion
Dim returnValue As ItemMetadata

returnValue = instance.CreateItemMetadata(globalId, creationVersion)

public abstract ItemMetadata CreateItemMetadata (
    SyncId globalId,
    SyncVersion creationVersion
)

public:
virtual ItemMetadata^ CreateItemMetadata (
    SyncId^ globalId, 
    SyncVersion^ creationVersion
) abstract

public abstract ItemMetadata CreateItemMetadata (
    SyncId globalId, 
    SyncVersion creationVersion
)

public abstract function CreateItemMetadata (
    globalId : SyncId, 
    creationVersion : SyncVersion
) : ItemMetadata

Parametri

globalId
ID globale dell'elemento da creare. L'ID globale deve essere univoco.

creationVersion
Versione di creazione da associare all'elemento.

Valore restituito

Oggetto di metadati dell'elemento appena creato.

Eccezioni

Tipo di eccezione	Condizione
ObjectDisposedException	L'oggetto è stato eliminato o non è stato inizializzato correttamente.
ArgumentNullException	globalId o creationVersion è Null.
OutOfMemoryException	La memoria disponibile non è sufficiente per creare i metadati dell'elemento.
SyncIdFormatMismatchException	Il formato di globalId non corrisponde a quello specificato durante l'inizializzazione dei metadati della replica.

Osservazioni

I metadati dell'elemento vengono salvati nell'archivio dei metadati solo dopo la chiamata a SaveItemMetadata.

Esempio

Nell'esempio seguente vengono creati i metadati per un elemento e vengono impostati la versione delle unità di modifica per ogni unità di modifica nell'elemento e i valori di campo personalizzati per i campi di indice dell'elemento.

private ItemMetadata CreateContactMetadata(Contact contact, SyncId itemId, SyncVersion creationVersion,
    SyncVersion changeVersion)
{
    // Create the item by using the metadata storage service.
    ItemMetadata itemMeta = _ContactReplicaMetadata.CreateItemMetadata(itemId, creationVersion);

    // Set the version information for each change unit.
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.NameCU), changeVersion);
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.PhoneCU), changeVersion);
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.AddressCU), changeVersion);
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.BirthdateCU), changeVersion);

    // A unique index is defined for the combination of first name, last name, and phone number in order
    // to map between the item ID and the contact.
    // Set the field values for the index fields.
    itemMeta.SetCustomField(FirstNameField, contact.FirstName);
    itemMeta.SetCustomField(LastNameField, contact.LastName);
    itemMeta.SetCustomField(PhoneNumberField, contact.PhoneNumber);

    return itemMeta;
}

Vedere anche

Riferimento

Classe ReplicaMetadata
Membri ReplicaMetadata
Spazio dei nomi Microsoft.Synchronization.MetadataStorage

Condividi tramite