Compartir a través de

GetNextTickCount Método

  • Artículo

Cuando se invalida en una clase derivada, incrementa el contador guardado previamente para esta réplica, guarda el nuevo valor en el almacén y devuelve el nuevo valor.

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

Sintaxis

'Declaración
Public MustOverride Function GetNextTickCount As ULong
'Uso
Dim instance As ReplicaMetadata
Dim returnValue As ULong

returnValue = instance.GetNextTickCount()

public abstract ulong GetNextTickCount()

public:
virtual unsigned long long GetNextTickCount() abstract

abstract GetNextTickCount : unit -> uint64 

public abstract function GetNextTickCount() : ulong

Valor devuelto

Tipo: System. . :: . .UInt64
Nuevo valor de contador para esta réplica.

Excepciones

Excepción Condición
ObjectDisposedException

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

Notas

La implementación de esta clase que está disponible mediante SqlMetadataStore guarda inmediatamente el valor incrementado en el almacén. Si hay una transacción explícita pendiente, la operación se producirá dentro de esa transacción y se revertirá si la transacción no está confirmada o se ha revertido.

Este método resulta útil a los proveedores principalmente en una de las circunstancias siguientes:

  • Sync Framework llama a GetNextTickCount en un objeto INotifyingChangeApplierTarget. Sync Framework espera que el destino del aplicador de cambios devuelva un nuevo valor de contador que puede usar para asignar una nueva versión local para un elemento.

  • El proveedor está realizando el mantenimiento de los metadatos en su almacén y tiene que asignar nuevas versiones a los cambios que se realizaron a través de algún mecanismo distinto de la sincronización. Para los cambios de este tipo, se puede construir una versión combinando la clave de réplica local y el contador siguiente que se obtiene llamando a GetNextTickCount.

  • El proveedor está realizando el seguimiento de las actualizaciones de su almacén y desea establecer una nueva versión para cada actualización que se produzca. La nueva versión se puede crear combinando la clave de réplica local con el contador siguiente que se obtiene llamando a GetNextTickCount.

Si un proveedor desea el contador actual en lugar del contador siguiente, puede llamar a GetKnowledge para obtener el conocimiento actual y, a continuación, extraer de él el valor del contador actual.

Ejemplos

En el ejemplo siguiente se implementa INotifyingChangeApplierTarget..::..GetNextTickCount llamando a ReplicaMetadata..::..GetNextTickCount:

public ulong GetNextTickCount()
{
    return _ContactStore.ContactReplicaMetadata.GetNextTickCount();
}

Vea también

Referencia

ReplicaMetadata Clase

ReplicaMetadata Miembros

Microsoft.Synchronization.MetadataStorage Espacio de nombres