次の方法で共有

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

戻り値

このレプリカの新しいティック数の値です。

例外

例外の種類 条件

ObjectDisposedException

オブジェクトが破棄されているか、正しく初期化されていません。

解説

SqlMetadataStore を使用することによって可能になるこのクラスの実装では、増分値がストアに直ちに保存されます。未処理の明示的なトランザクションがある場合、操作はそのトランザクション内で行われます。トランザクションがコミットされていないか、ロールバックされている場合、操作はロールバックされます。

このメソッドは、主に次のいずれかの状況に置かれたプロバイダーにとって役立ちます。

  • Sync Framework が INotifyingChangeApplierTarget オブジェクト上の GetNextTickCount を呼び出す場合。Sync Framework は、項目に新しいローカル バージョンを割り当てるための新しいティック数の値が変更適用元のターゲットによって返されることを想定しています。

  • プロバイダーがそのストアに対してメタデータ メンテナンスを実行しており、同期以外のメカニズムによって加えた変更に新しいバージョンを割り当てる必要がある場合。これらの変更のバージョンを構築するには、GetNextTickCount を呼び出すことによって取得される次のティック数とローカルのレプリカ キーを組み合わせます。

  • プロバイダーがそのストアに対する更新を追跡しており、加えられた更新ごとに新しいバージョンを設定する必要がある場合。新しいバージョンを作成するには、GetNextTickCount を呼び出すことによって取得される次のティック数とローカルのレプリカ キーを組み合わせます。

プロバイダーは、次のティック数でなく現在のティック数が必要な場合、GetKnowledge を呼び出して現在のナレッジを取得した後で、そこから現在のティック数の値を抽出できます。

例

次の例では、ReplicaMetadata.GetNextTickCount を呼び出して INotifyingChangeApplierTarget.GetNextTickCount を実装しています。

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

参照

リファレンス

ReplicaMetadata クラス
ReplicaMetadata メンバー
Microsoft.Synchronization.MetadataStorage 名前空間