Метод ReplicaMetadata.GetNextTickCount

При переопределении в производном классе увеличивает ранее сохраненное значение счетчика тактов для данной реплики, сохраняет новое значение в хранилище и возвращает новое значение.

Пространство имен: Microsoft.Synchronization.MetadataStorage
Сборка: Microsoft.Synchronization.MetadataStorage (в microsoft.synchronization.metadatastorage.dll)

Синтаксис

'Декларация
Public MustOverride Function GetNextTickCount As ULong
'Применение
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

Возвращаемое значение

Новое значение счетчика тактов для этой реплики.

Исключения

Замечания

Реализация этого класса, которая возможна через класс SqlMetadataStore, производит немедленное сохранение увеличенного значения в хранилище. Если существует незавершенная явная транзакция, то операция будет выполнена в контексте этой транзакции и может быть подвергнута отказу, если эта транзакция ни зафиксирована, ни откачена.

Этот метод может оказаться полезным для поставщиков в следующих случаях.

• Sync Framework вызывает метод GetNextTickCount объекта INotifyingChangeApplierTarget и ожидает, что цель объекта применения изменений Sync Framework вернет значение счетчика тактов, которое может быть использовано для присвоения элементу новой локальной версии.

• Поставщик выполняет обслуживание метаданных в своем хранилище и должен присвоить новые версии тем изменениям, которые были выполнены с использованием механизмов, отличных от синхронизации. Версия такого изменения может быть собрана путем совмещения ключа локальной реплики и следующего значения счетчика тактов, полученного вызовом метода GetNextTickCount.

• Поставщик отслеживает изменения в своем хранилище, и ему необходимо установить новую версию для каждого произошедшего изменения. Новая версия может быть создана путем совмещения ключа локальной реплики и следующего значения счетчика тактов, полученного вызовом метода GetNextTickCount.

Если поставщику необходимо не следующее, а текущее значение счетчика тактов, он может вызвать метод GetKnowledge, чтобы получить текущий набор знаний, а затем извлечь из него текущее значение счетчика тактов.

Пример

В следующем примере показана реализация метода INotifyingChangeApplierTarget.GetNextTickCount через вызов метода ReplicaMetadata.GetNextTickCount.

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

См. также

Справочник

Класс ReplicaMetadata
Элементы ReplicaMetadata
Пространство имен Microsoft.Synchronization.MetadataStorage