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 命名空间