Метод ItemChange.AddFilterChange

Добавляет сведения, которые указывают, вызвано ли этим изменением перемещение элемента в указанный фильтр или из него.

Пространство имен: Microsoft.Synchronization
Сборка: Microsoft.Synchronization (в microsoft.synchronization.dll)

Синтаксис

'Декларация
Public Sub AddFilterChange ( _
    filterKey As UInteger, _
    filterChange As FilterChange _
)
'Применение
Dim instance As ItemChange
Dim filterKey As UInteger
Dim filterChange As FilterChange

instance.AddFilterChange(filterKey, filterChange)

public void AddFilterChange (
    uint filterKey,
    FilterChange filterChange
)

public:
void AddFilterChange (
    unsigned int filterKey, 
    FilterChange^ filterChange
)

public void AddFilterChange (
    UInt32 filterKey, 
    FilterChange filterChange
)

public function AddFilterChange (
    filterKey : uint, 
    filterChange : FilterChange
)

Параметры

• filterKey
  Ключ фильтра, в область действия которого попадает элемент или из области действия которого элемент выходит.

• filterChange
  Сведения об изменении, относящиеся к фильтру, указанному ключом filterKey.

Исключения

Замечания

Изменение может вызвать перемещение элемента в фильтр или из фильтра. Например, элементы содержат поле state, а фильтр исключает все элементы, в которых поле state имеет значение «Washington». Если элемент, в котором поле state имеет значение «Washington», изменяется таким образом, что поле state получает значение «Oregon», то элемент перемещается в фильтр.

Пример

В следующем примере производится добавление данных изменения фильтра в объект ItemChange, когда версия перемещения элемента в отношении фильтра не содержится в наборе знаний назначения.

Public Sub AddFilterChanges(ByVal filterKeyMap As FilterKeyMap, ByVal itemMeta As ItemMetadata, ByVal destKnowledge As SyncKnowledge, ByVal itemChange As ItemChange)
    For filterKey As Integer = 0 To filterKeyMap.Count - 1
        ' Find the filter in the list of all filters tracked by this replica.
        Dim iFilter As Integer = 0
        While iFilter < _trackedFilters.Count
            If filterKeyMap(filterKey).IsIdentical(_trackedFilters(iFilter)) Then
                Exit While
            End If
            iFilter += 1
        End While

        ' Get the filter information for the item and add it to the ItemChange object.
        Dim moveVersion As SyncVersion = GetMoveVersion(itemMeta, iFilter)

        ' Only return a filter change if the destination knowledge does not contain the version of the 
        ' last move that occurred in relation to the specified filter.
        Dim filterChange As FilterChange = Nothing
        If Not destKnowledge.Contains(ContactReplicaMetadata.ReplicaId, itemMeta.GlobalId, moveVersion) Then
            filterChange = New FilterChange(GetIsInFilter(itemMeta, iFilter), moveVersion)
            itemChange.AddFilterChange(CUInt(filterKey), filterChange)
        End If
    Next
End Sub

public void AddFilterChanges(FilterKeyMap filterKeyMap, ItemMetadata itemMeta, SyncKnowledge destKnowledge,
    ItemChange itemChange)
{
    for (int filterKey = 0; filterKey < filterKeyMap.Count; filterKey++)
    {
        // Find the filter in the list of all filters tracked by this replica.
        int iFilter = 0;
        for (; iFilter < _trackedFilters.Count; iFilter++)
        {
            if (filterKeyMap[filterKey].IsIdentical(_trackedFilters[iFilter]))
            {
                break;
            }
        }

        // Get the filter information for the item and add it to the ItemChange object.
        SyncVersion moveVersion = GetMoveVersion(itemMeta, iFilter);

        // Only return a filter change if the destination knowledge does not contain the version of the 
        // last move that occurred in relation to the specified filter.
        FilterChange filterChange = null;
        if (!destKnowledge.Contains(ContactReplicaMetadata.ReplicaId, itemMeta.GlobalId, moveVersion))
        {
            filterChange = new FilterChange(GetIsInFilter(itemMeta, iFilter), moveVersion);
            itemChange.AddFilterChange((uint)filterKey, filterChange);
        }
    }
}

См. также

Справочник

Класс ItemChange
Элементы ItemChange
Пространство имен Microsoft.Synchronization