篩選簡單提供者的資料
在某些狀況中，目的地複寫只需要可在來源複寫上使用的資料子集。例如，銷售人員可能只需要他定期銷售之產品的詳細產品資訊。簡單提供者可讓複寫篩選資料，其方式是實作篩選介面。藉由篩選資料，您可以執行下列事項：
減少在網路上傳送的資料量。
減少複寫上所需要的儲存空間。這一點對於裝置而言特別重要。
根據個別複寫需求來提供自訂的資料分割。
因為不同的資料分割可以送往不同的複寫，因此也能夠避免或減少衝突。
請留意，簡單提供者不可使用自訂篩選，否則可能會發生非預期的結果。自訂篩選是指使用 CustomFilterInfo 類別 (適用於 Managed 程式碼) 或 ICustomFilterInfo 介面 (適用於 Unmanaged 程式碼) 的篩選。
若要篩選資料，請使用以下介面：
Managed 程式碼：IFilteredSimpleSyncProvider、IRequestFilteredSync 和 ISupportFilteredSync
機器碼：IFilteredSimpleSyncProvider、IRequestFilteredSync 和 ISupportFilteredSync
Managed 程式碼範例
下列程式碼範例會使用篩選交涉介面來判斷，同步處理工作階段期間是否應該使用特定篩選。篩選交涉可讓目的地提供者指定來源提供者應該在變更列舉期間使用一個或多個篩選；來源提供者可以接受或拒絕篩選。如果來源提供者不支援任何要求的篩選，目的地提供者可選擇接收所有資料，然後自己執行篩選。Sync Framework 會適當地呼叫提供者來交涉篩選的使用。
public bool RequestFilter
{
set
{
_requestFilter = value;
}
}
private bool _requestFilter = false;
void IRequestFilteredSync.SpecifyFilter(FilterRequestCallback filterRequest)
{
// Request a filter only if this provider represents a filtered replica.
if (_requestFilter)
{
if (!filterRequest("TheFilter", FilteringType.CurrentItemsOnly))
{
throw new SyncInvalidOperationException("Could not agree on filter.");
}
}
}
bool ISupportFilteredSync.TryAddFilter(object filter, FilteringType filteringType)
{
if (!((string)filter).Equals("TheFilter"))
{
throw new Exception("Filter is incorrect");
}
// Remember the filter.
_filter = (string)filter;
return true;
}
private string _filter = "";
Public WriteOnly Property RequestFilter() As Boolean
Set(ByVal value As Boolean)
_requestFilter = value
End Set
End Property
Private _requestFilter As Boolean = False
Private Sub SpecifyFilter(ByVal filterRequest As FilterRequestCallback) Implements IRequestFilteredSync.SpecifyFilter
' Request a filter only if this provider represents a filtered replica.
If _requestFilter Then
If Not filterRequest("TheFilter", FilteringType.CurrentItemsOnly) Then
Throw New SyncInvalidOperationException("Could not agree on filter.")
End If
End If
End Sub
Private Function TryAddFilter(ByVal filter As Object, ByVal filteringType As FilteringType) As Boolean Implements ISupportFilteredSync.TryAddFilter
If Not DirectCast(filter, String).Equals("TheFilter") Then
Throw New Exception("Filter is incorrect")
End If
' Remember the filter.
_filter = DirectCast(filter, String)
Return True
End Function
Private _filter As String = ""
下列程式碼範例會先指定 None 的篩選選項。這表示應該篩選出項目，即使目的地已知這些項目也是。此程式碼範例然後實作 IsItemInFilterScope 方法，依據其中一個項目欄位值篩選出項目。在定義篩選之後，程式碼範例會實作 UseFilterThisSession 方法。如此可讓應用程式指定，是否應該根據每個工作階段來使用篩選。
SimpleSyncProviderFilterOptions IFilteredSimpleSyncProvider.FilterOptions
{
get
{
return SimpleSyncProviderFilterOptions.None;
}
}
bool IFilteredSimpleSyncProvider.IsItemInFilterScope(ItemFieldDictionary KeyAndVersion)
{
ulong itemId = (ulong)KeyAndVersion[1].Value;
ItemData itemData = _store.Get(itemId);
if (itemData["data"] == "3333")
{
return false;
}
return true;
}
bool IFilteredSimpleSyncProvider.UseFilterThisSession
{
get
{
// Indicate whether a filter has been requested and agreed upon for this session.
return ("" != _filter);
}
}
Private ReadOnly Property FilterOptions() As SimpleSyncProviderFilterOptions Implements IFilteredSimpleSyncProvider.FilterOptions
Get
Return SimpleSyncProviderFilterOptions.None
End Get
End Property
Private Function IsItemInFilterScope(ByVal KeyAndVersion As ItemFieldDictionary) As Boolean Implements IFilteredSimpleSyncProvider.IsItemInFilterScope
Dim itemId As ULong = KeyAndVersion(1).Value
Dim data As ItemData = _store.Get(itemId)
If data("data") Is "3333" Then
Return False
End If
Return True
End Function
Private ReadOnly Property UseFilterThisSession() As Boolean Implements IFilteredSimpleSyncProvider.UseFilterThisSession
Get
' Indicate whether a filter has been requested and agreed upon for this session.
Return "" Is _filter
End Get
End Property