GetFullEnumerationChangeBatch 方法

發行項
08/18/2010

在衍生類別中覆寫時，會取得變更批次，其中包含識別碼大於指定之下限之項目的項目中繼資料 (完整列舉的一部分)。

命名空間： 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
項目識別碼的下限。這個方法會傳回識別碼大於或等於此識別碼值的變更。

knowledgeForDataRetrieval
型別：Microsoft.Synchronization. . :: . .SyncKnowledge
如果某個項目變更包含在這個知識物件中，就表示該項目的資料已經存在目的地複寫上。

changeDataRetriever
型別：System. . :: . .Object%
傳回可用來擷取變更資料的物件。它可以是 IChangeDataRetriever 物件或提供者特有的物件。

傳回值

型別：Microsoft.Synchronization. . :: . .FullEnumerationChangeBatch
變更批次，其中包含識別碼大於指定之下限之項目的項目中繼資料 (完整列舉的一部分)。

備註

在被遺忘的知識復原期間，Sync Framework 會呼叫這個方法。

這個方法會依照項目識別碼的排序次序來列舉項目識別碼等於或大於 lowerEnumerationBound 的變更。如此可讓 Sync Framework 判斷目的地提供者上的哪些項目已被刪除，但是被來源提供者所遺忘。此方法也可以選擇依項目識別碼排序，將變更加入至項目識別碼小於 lowerEnumerationBound 及未包含於目的地知識內的批次中。

實作器注意事項

如果這個批次之後沒有其他變更要傳送，就必須在傳回的變更批次上將 IsLastBatch 設定為 true。否則，Sync Framework 會再次呼叫 GetFullEnumerationChangeBatch 來擷取另一個變更批次。

對於要同時傳送項目資料與項目變更中繼資料的提供者，可以使用 knowledgeForDataRetrieval 來判斷是否必須傳送項目資料。如果項目變更是包含在 knowledgeForDataRetrieval 中，就不需要傳送項目資料。