GetFullEnumerationChangeBatch メソッド
派生クラスでオーバーライドされると、ID が指定された下限を上回る項目の項目メタデータが含まれる変更バッチを、完全な列挙の一部として取得します。
名前空間: Microsoft.Synchronization
アセンブリ: Microsoft.Synchronization (Microsoft.Synchronization.dll 内)
構文
'宣言
Public MustOverride Function GetFullEnumerationChangeBatch ( _
batchSize As UInteger, _
lowerEnumerationBound As SyncId, _
knowledgeForDataRetrieval As SyncKnowledge, _
<OutAttribute> ByRef changeDataRetriever As Object _
) As FullEnumerationChangeBatch
'使用
Dim instance As KnowledgeSyncProvider
Dim batchSize As UInteger
Dim lowerEnumerationBound As SyncId
Dim knowledgeForDataRetrieval As SyncKnowledge
Dim changeDataRetriever As Object
Dim returnValue As FullEnumerationChangeBatch
returnValue = instance.GetFullEnumerationChangeBatch(batchSize, _
lowerEnumerationBound, knowledgeForDataRetrieval, _
changeDataRetriever)
public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch(
uint batchSize,
SyncId lowerEnumerationBound,
SyncKnowledge knowledgeForDataRetrieval,
out Object changeDataRetriever
)
public:
virtual FullEnumerationChangeBatch^ GetFullEnumerationChangeBatch(
unsigned int batchSize,
SyncId^ lowerEnumerationBound,
SyncKnowledge^ knowledgeForDataRetrieval,
[OutAttribute] Object^% changeDataRetriever
) abstract
abstract GetFullEnumerationChangeBatch :
batchSize:uint32 *
lowerEnumerationBound:SyncId *
knowledgeForDataRetrieval:SyncKnowledge *
changeDataRetriever:Object byref -> FullEnumerationChangeBatch
public abstract function GetFullEnumerationChangeBatch(
batchSize : uint,
lowerEnumerationBound : SyncId,
knowledgeForDataRetrieval : SyncKnowledge,
changeDataRetriever : Object
) : FullEnumerationChangeBatch
パラメーター
- batchSize
型 : System. . :: . .UInt32
変更バッチに含める変更の数です。
- lowerEnumerationBound
型 : Microsoft.Synchronization. . :: . .SyncId
項目 ID の下限です。このメソッドでは、ID がこの値以上の変更が返されます。
- knowledgeForDataRetrieval
型 : Microsoft.Synchronization. . :: . .SyncKnowledge
項目変更がこのナレッジ オブジェクトに含まれている場合、その項目のデータは既に同期先レプリカに存在します。
- changeDataRetriever
型 : System. . :: . .Object%
変更データを取得するために使用できるオブジェクトを返します。これには、IChangeDataRetriever オブジェクトまたはプロバイダー固有のオブジェクトを指定できます。
戻り値
型 : Microsoft.Synchronization. . :: . .FullEnumerationChangeBatch
完全な列挙の一部として、ID が指定された下限を上回る項目の項目メタデータが含まれた変更バッチです。
説明
このメソッドは、忘れられたナレッジの復旧時に Sync Framework によって呼び出されます。
このメソッドは、項目 ID が lowerEnumerationBound 以上の変更を項目 ID の順で列挙します。これにより、Sync Framework は、同期先プロバイダーのどの項目が同期元プロバイダーによって削除され、忘れられているかを特定できます。 このメソッドでは、オプションで、同期先ナレッジに含まれていない、項目 ID が lowerEnumerationBound より小さい変更を、項目 ID の順にバッチに追加することもできます。
実装に関するメモ
このバッチの後で送信する変更がもうない場合は、返される変更バッチで IsLastBatch を true に設定する必要があります。そうしないと、次の変更バッチを取得するために、Sync Framework によって GetFullEnumerationChangeBatch が再度呼び出されます。
項目変更に関するメタデータと共に項目データを送信するプロバイダーでは、knowledgeForDataRetrieval を使用して、項目データの送信が必要かどうかを判断できます。項目変更が knowledgeForDataRetrieval に含まれている場合、項目データを送信する必要はありません。
参照
参照
Microsoft.Synchronization 名前空間