Share via

KnowledgeSyncProvider.GetChangeBatch 方法

  • 發行項

在衍生類別中覆寫時，會取得變更批次，其中包含目的地提供者之指定知識內未包含之項目的項目中繼資料 (Metadata)。

命名空間: Microsoft.Synchronization
組件: Microsoft.Synchronization (在 microsoft.synchronization.dll)

語法

'宣告
Public MustOverride Function GetChangeBatch ( _
    batchSize As UInteger, _
    destinationKnowledge As SyncKnowledge, _
    <OutAttribute> ByRef changeDataRetriever As Object _
) As ChangeBatch
'用途
Dim instance As KnowledgeSyncProvider
Dim batchSize As UInteger
Dim destinationKnowledge As SyncKnowledge
Dim changeDataRetriever As Object
Dim returnValue As ChangeBatch

returnValue = instance.GetChangeBatch(batchSize, destinationKnowledge, changeDataRetriever)

public abstract ChangeBatch GetChangeBatch (
    uint batchSize,
    SyncKnowledge destinationKnowledge,
    out Object changeDataRetriever
)

public:
virtual ChangeBatch^ GetChangeBatch (
    unsigned int batchSize, 
    SyncKnowledge^ destinationKnowledge, 
    [OutAttribute] Object^% changeDataRetriever
) abstract

public abstract ChangeBatch GetChangeBatch (
    UInt32 batchSize, 
    SyncKnowledge destinationKnowledge, 
    /** @attribute OutAttribute() */ /** @ref */ Object changeDataRetriever
)

JScript does not support passing value-type arguments by reference.

參數

  • batchSize
    要包含在變更批次中的變更數目。
  • destinationKnowledge
    目的地提供者的知識。您必須先針對來源知識呼叫 MapRemoteKnowledgeToLocal 來對應這個知識，然後才能將它用於變更列舉。
  • changeDataRetriever
    傳回可用來擷取變更資料的物件。它可以是 IChangeDataRetriever 物件或提供者特有的物件。

傳回值

變更批次，其中包含目的地提供者之指定知識內未包含之項目的項目中繼資料。不能為 null 參考 (在 Visual Basic 中為 Nothing)。

備註

相同的變更不會出現在多個批次中。

如果剩餘的變更數目小於 batchSize 指定的數目，就會傳回較小的批次。

如果在沒有剩餘的變更時呼叫這個方法，它就會擲回 InvalidOperationException。

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

請參閱

參考

KnowledgeSyncProvider 類別
KnowledgeSyncProvider 成員
Microsoft.Synchronization 命名空間