Метод ReplicaMetadata.GetNextTickCount

Статья
10/17/2009

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

Пространство имен: 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

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

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

Исключения

Тип исключения	Условие
ObjectDisposedException	Объект удален или неправильно инициализирован.

Замечания

Реализация этого класса, которая возможна через класс 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

Поделиться через