FilterRequestCallback 委派
表示在目的地提供者與來源提供者之間協調篩選交涉的方法。
命名空間: Microsoft.Synchronization
組件: Microsoft.Synchronization (在 Microsoft.Synchronization.dll 中)
語法
'宣告
Public Delegate Function FilterRequestCallback ( _
filter As Object, _
filterType As FilteringType _
) As Boolean
'用途
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
參數
- filter
型別:System. . :: . .Object
目的地提供者所指定的篩選。這個篩選會傳遞給要在變更列舉期間使用的來源提供者。
- filterType
型別:Microsoft.Synchronization. . :: . .FilteringType
傳回值
型別:System. . :: . .Boolean
如果來源提供者支援 filter 所指定的篩選,則為 True,否則為 false。
備註
FilterRequestCallback 是由 Sync Framework 實作。
篩選交涉是使用下列步驟所達成:
在來源提供者開始列舉變更之前,Sync Framework 會呼叫目的地提供者所實作之 IRequestFilteredSync 介面的 SpecifyFilter 方法,藉以啟動篩選交涉。
在處理 SpecifyFilter 期間,目的地提供者會將篩選傳遞給 Sync Framework 所指定的 FilterRequestCallback。
在處理 FilterRequestCallback 期間,Sync Framework 會呼叫來源提供者所實作之 ISupportFilteredSync 介面的 TryAddFilter(Object) 方法。如果來源提供者不支援要求的篩選,目的地提供者就可以繼續要求篩選,直到它找到支援的篩選為止。
成功交涉篩選之後,來源提供者就會用它來判斷要在變更列舉期間包含哪些項目。