ReplicaMetadata.GetFilteredFullEnumerationLocalVersions-Methode

Artikel
11/02/2009

Ruft, wenn in einer abgeleiteten Klasse überschrieben, einen gefilterten Änderungsbatch mit Elementversionen und Änderungseinheiten ab, die in diesem Replikat gespeichert sind und den Elementen und Änderungseinheiten entsprechen, auf die in einem Änderungsbatch verwiesen wird, der von einem anderen Anbieter im Zuge einer vollständigen Enumeration gesendet wurde.

Namespace: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (in microsoft.synchronization.metadatastorage.dll)

Syntax

'Declaration
Public MustOverride Function GetFilteredFullEnumerationLocalVersions ( _
    sourceChanges As FullEnumerationChangeBatch, _
    filterCallback As ItemFilterCallback _
) As IEnumerable(Of ItemChange)
'Usage
Dim instance As ReplicaMetadata
Dim sourceChanges As FullEnumerationChangeBatch
Dim filterCallback As ItemFilterCallback
Dim returnValue As IEnumerable(Of ItemChange)

returnValue = instance.GetFilteredFullEnumerationLocalVersions(sourceChanges, filterCallback)

public abstract IEnumerable<ItemChange> GetFilteredFullEnumerationLocalVersions (
    FullEnumerationChangeBatch sourceChanges,
    ItemFilterCallback filterCallback
)

public:
virtual IEnumerable<ItemChange^>^ GetFilteredFullEnumerationLocalVersions (
    FullEnumerationChangeBatch^ sourceChanges, 
    ItemFilterCallback^ filterCallback
) abstract

public abstract IEnumerable<ItemChange> GetFilteredFullEnumerationLocalVersions (
    FullEnumerationChangeBatch sourceChanges, 
    ItemFilterCallback filterCallback
)

public abstract function GetFilteredFullEnumerationLocalVersions (
    sourceChanges : FullEnumerationChangeBatch, 
    filterCallback : ItemFilterCallback
) : IEnumerable<ItemChange>

Parameter

sourceChanges
Der Änderungsbatch, der von einem anderen Anbieter gesendet wurde und auf den Elementspeicher angewendet werden soll, der diesem Replikat zugeordnet ist.

filterCallback
Der Delegat, der aufgerufen wird, um zu bestimmen, ob das Element dem Batch hinzugefügt werden soll.

Rückgabewert

Ein gefilterter Änderungsbatch, der die Versionen von Elementen und Änderungseinheiten enthält, die in diesem Replikat gespeichert sind und den Elementen und Änderungseinheiten entsprechen, auf die in einem Änderungsbatch verwiesen wird, der von einem anderen Anbieter im Zuge einer vollständigen Enumeration gesendet wurde.

Hinweise

Diese Methode unterstützt einen Synchronisierungsanbieter bei der Implementierung seiner ProcessFullEnumerationChangeBatch-Methode, wenn der Zielanbieter Änderungen filtert.

Beim Anwenden von Änderungen werden zur Konflikterkennung die Versionen im Änderungsbatch verwendet, die von dieser Methode zurückgegeben werden.

Der filterCallback-Delegat wird vor dem Hinzufügen jedes Elements zu einem Batch aufgerufen. Wenn der Delegat true zurückgibt, wird das Element dem Batch hinzugefügt, andernfalls wird es nicht hinzugefügt.

Hinweise für Implementierer: Der von dieser Methode zurückgegebene Änderungsbatch muss einen Eintrag für jedes Element enthalten, dessen Element-ID zwischen der in sourceChanges angegebenen Unter- und Obergrenze liegt, einschließlich Änderungseinheitseinträgen. Dies gilt jedoch nicht, wenn filterCallback angibt, dass der Eintrag nicht berücksichtigt werden soll. Wenn im Elementspeicher ein Element vorhanden ist und vom Filter berücksichtigt wird, muss dessen Eintrag die Versionsinformationen für dieses Replikat enthalten. Wenn ein durch den Filter eingeschlossenes Element nicht vorhanden ist, muss dessen Version auf SyncVersion.UnknownVersion und dessen P:Microsoft.Synchronization.ItemChange.ChangeKind-Eigenschaft auf UnknownItem festgelegt werden.

Siehe auch

Verweis

ReplicaMetadata-Klasse
ReplicaMetadata-Member
Microsoft.Synchronization.MetadataStorage-Namespace

Freigeben über