Método ReplicaMetadata.GetNextTickCount

Artigo
10/17/2009

Quando substituído em uma classe derivada, aumenta a contagem em escala salva anteriormente para essa réplica, salva o novo valor no repositório e retorna o novo valor.

Namespace: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (em microsoft.synchronization.metadatastorage.dll)

Sintaxe

'Declaração
Public MustOverride Function GetNextTickCount As ULong
'Uso
Dim instance As ReplicaMetadata
Dim returnValue As ULong

returnValue = instance.GetNextTickCount

public abstract ulong GetNextTickCount ()

public:
virtual usigned long long GetNextTickCount () abstract

public abstract UInt64 GetNextTickCount ()

public abstract function GetNextTickCount () : ulong

Valor de retorno

O novo valor da contagem em escala desta réplica.

Exceções

Tipo de exceção	Condição
ObjectDisposedException	O objeto foi descartado ou não foi inicializado corretamente.

Comentários

A implementação desta classe, que está disponível através de SqlMetadataStore, salva imediatamente o valor incrementado no repositório. Se houver uma transação explícita pendente, a operação acontecerá dentro daquela transação e será revertida se a transação não for confirmada ou revertida.

Este método é especialmente útil para os provedores em uma das seguintes circunstâncias:

Sync Framework chama GetNextTickCount. Em um objeto INotifyingChangeApplierTarget, o Sync Framework espera que o destino do aplicador de alterações retorne um novo valor da contagem em escala que possa ser usado para atribuir uma nova versão local a um item.
O provedor está fazendo manutenção dos metadados em seu repositório e tem que atribuir novas versões para alterações que foram feitas por algum outro mecanismo, que não a sincronização. Uma versão para tal alteração pode ser criada com a combinação da chave de réplica local e da próxima conta de marcação que é obtida chamando GetNextTickCount.
O provedor está controlando atualizações em seu repositório e quer definir uma nova versão para cada atualização que houver. A versão pode ser criada com a combinação da chave de réplica local e da próxima conta de marcação que é obtida chamando GetNextTickCount.

Se um provedor desejar a contagem em escala atual em vez da próxima contagem em escala, ele poderá chamar GetKnowledge para obter o conhecimento atual e, em seguida, extrair dele o valor da contagem em escala atual.

Exemplo

O exemplo a seguir implementa INotifyingChangeApplierTarget.GetNextTickCount chamando ReplicaMetadata.GetNextTickCount:

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

Consulte também

Referência

Classe ReplicaMetadata
Membros ReplicaMetadata
Namespace Microsoft.Synchronization.MetadataStorage

Compartilhar via