CreateItemMetadata Método

  • Artículo

Cuando se invalida en una clase derivada, crea un nuevo objeto de metadatos de elemento que se puede usar para agregar una nueva entrada de metadatos de elemento al almacén de metadatos.

Espacio de nombres:  Microsoft.Synchronization.MetadataStorage
Ensamblado:  Microsoft.Synchronization.MetadataStorage (en Microsoft.Synchronization.MetadataStorage.dll)

Sintaxis

'Declaración
Public MustOverride Function CreateItemMetadata ( _
    globalId As SyncId, _
    creationVersion As SyncVersion _
) As ItemMetadata
'Uso
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

abstract CreateItemMetadata : 
        globalId:SyncId * 
        creationVersion:SyncVersion -> ItemMetadata 

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

Parámetros

Valor devuelto

Tipo: Microsoft.Synchronization.MetadataStorage. . :: . .ItemMetadata
Objeto de metadatos de elemento que se acaba de crear.

Excepciones

Excepción Condición
ObjectDisposedException

El objeto se ha eliminado o no se ha inicializado correctamente.
ArgumentNullException

globalId o creationVersion es un valor null Nothing nullptr unit es una referencia NULL (Nothing en Visual Basic). .
OutOfMemoryException

Memoria insuficiente para crear los metadatos de elemento.
SyncIdFormatMismatchException

El formato de globalId no coincide con el formato que se especificó cuando se inicializaron los metadatos de la réplica.

Notas

Estos metadatos del elemento no se guardan en el almacén de metadatos hasta que se llama a SaveItemMetadata.

Ejemplos

En el ejemplo siguiente se crean los metadatos para un elemento, se establece la versión de la unidad de cambio para cada unidad de cambio del elemento y se establecen los valores de campo personalizado para los campos del índice del 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;
}

Vea también

Referencia

ReplicaMetadata Clase

ReplicaMetadata Miembros

Microsoft.Synchronization.MetadataStorage Espacio de nombres