Freigeben über


FilterRequestCallback-Delegat

Stellt die Methode dar, die Filteraushandlungen zwischen einem Zielanbieter und einem Quellenanbieter vermittelt.

Namespace:  Microsoft.Synchronization
Assembly:  Microsoft.Synchronization (in Microsoft.Synchronization.dll)

Syntax

'Declaration
Public Delegate Function FilterRequestCallback ( _
    filter As Object, _
    filterType As FilteringType _
) As Boolean
'Usage
Dim instance As New FilterRequestCallback(AddressOf HandlerMethod)
public delegate bool FilterRequestCallback(
    Object filter,
    FilteringType filterType
)
public delegate bool FilterRequestCallback(
    Object^ filter, 
    FilteringType filterType
)
type FilterRequestCallback = 
    delegate of 
        filter:Object * 
        filterType:FilteringType -> bool

Parameter

  • filter
    Typ: System. . :: . .Object
    Der Filter, der vom Zielanbieter angegeben wird. Dieser Filter wird dem Quellenanbieter zur Verwendung während der Änderungsenumeration übergeben.

Rückgabewert

Typ: System. . :: . .Boolean
true , wenn der von filter angegebene Filter vom Quellenanbieter unterstützt wird. Andernfalls false.

Hinweise

FilterRequestCallback wird von Sync Framework implementiert.

Die Filteraushandlung wird mit den folgenden Schritten durchgeführt:

  1. Bevor der Quellenanbieter mit der Auflistung der Änderungen beginnt, startet Sync Framework die Filteraushandlung, indem die SpecifyFilter-Methode der IRequestFilteredSync-Schnittstelle aufgerufen wird, die vom Zielanbieter implementiert wurde.

  2. Während der Verarbeitung von SpecifyFilter übergibt der Zielanbieter Filter an den von Sync Framework angegebenen FilterRequestCallback.

  3. Während der Verarbeitung von FilterRequestCallback ruft Sync Framework die TryAddFilter(Object)-Methode der ISupportFilteredSync-Schnittstelle auf, die vom Quellenanbieter implementiert wurde. Wenn der Quellenanbieter den angeforderten Filter nicht unterstützt, kann der Zielanbieter weiterhin Filter anfordern, bis ein unterstützter Filter gefunden wird.

Wenn ein Filter erfolgreich ausgehandelt wurde, wird er vom Quellenanbieter zur Festlegung der während der Änderungsenumeration einzuschließenden Elemente verwendet.

Siehe auch

Verweis

Microsoft.Synchronization-Namespace