ReplicaMetadata.GetFilteredLocalVersions 方法

在衍生類別中覆寫時，會取得包含此複寫內儲存之項目和變更單位版本的篩選變更批次。這些項目和變更單元對應到從某些其他提供者所傳送變更批次中參考的項目和變更單元。

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

語法

'宣告
Public MustOverride Function GetFilteredLocalVersions ( _
    sourceChanges As ChangeBatch, _
    filterCallback As ItemFilterCallback _
) As IEnumerable(Of ItemChange)
'用途
Dim instance As ReplicaMetadata
Dim sourceChanges As ChangeBatch
Dim filterCallback As ItemFilterCallback
Dim returnValue As IEnumerable(Of ItemChange)

returnValue = instance.GetFilteredLocalVersions(sourceChanges, filterCallback)

public abstract IEnumerable<ItemChange> GetFilteredLocalVersions (
    ChangeBatch sourceChanges,
    ItemFilterCallback filterCallback
)

public:
virtual IEnumerable<ItemChange^>^ GetFilteredLocalVersions (
    ChangeBatch^ sourceChanges, 
    ItemFilterCallback^ filterCallback
) abstract

public abstract IEnumerable<ItemChange> GetFilteredLocalVersions (
    ChangeBatch sourceChanges, 
    ItemFilterCallback filterCallback
)

public abstract function GetFilteredLocalVersions (
    sourceChanges : ChangeBatch, 
    filterCallback : ItemFilterCallback
) : IEnumerable<ItemChange>

參數

• sourceChanges
  即將套用到與此複寫有關之項目存放區的另一個提供者所傳送的變更批次。

• filterCallback
  所呼叫的委派，可用來判斷是否應該將此項目加入批次中。

傳回值

包含此複寫內所儲存之項目和變更單位版本的篩選變更批次，這些項目和變更單位會對應到變更批次內傳送自某個其他提供者的項目和變更單位。

備註

當目的地提供者篩選變更時，這個方法可協助同步處理提供者實作它的 ProcessChangeBatch 方法。

變更套用者會使用這個方法所傳回之變更批次內的版本進行衝突偵測。

在每一個項目加入至批次之前，將會呼叫 filterCallback 委派。如果此委派傳回 true，此項目會加入批次中，否則就不會加入。

實作器注意事項： 除非 filterCallback 指出不應該包含項目，否則對於 sourceChanges 中的每一個項目 (包括變更單位項目) 而言，從這個方法傳回的變更批次都必須包含一個項目。如果項目存放區內有項目存在，而且篩選包含此項目，它的項目必須包含它對於這個複寫的版本資訊。如果篩選所包含的項目不存在，它的版本必須設定為 SyncVersion.UnknownVersion，而它的 ItemChange.ChangeKind 屬性必須設定為 UnknownItem。

請參閱

參考

ReplicaMetadata 類別
ReplicaMetadata 成員
Microsoft.Synchronization.MetadataStorage 命名空間