Метод ReplicaMetadata.RemoveItemMetadata

При переопределении в производном классе этот метод удаляет метаданные элемента из хранилища метаданных.

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

Синтаксис

'Декларация
Public MustOverride Sub RemoveItemMetadata ( _
    globalIds As IEnumerable(Of SyncId) _
)
'Применение
Dim instance As ReplicaMetadata
Dim globalIds As IEnumerable(Of SyncId)

instance.RemoveItemMetadata(globalIds)
public abstract void RemoveItemMetadata (
    IEnumerable<SyncId> globalIds
)
public:
virtual void RemoveItemMetadata (
    IEnumerable<SyncId^>^ globalIds
) abstract
public abstract void RemoveItemMetadata (
    IEnumerable<SyncId> globalIds
)
public abstract function RemoveItemMetadata (
    globalIds : IEnumerable<SyncId>
)

Параметры

  • globalIds
    Коллекция глобальных идентификаторов элементов, подлежащих удалению.

Исключения

Тип исключения Условие

ObjectDisposedException

Объект удален или неправильно инициализирован.

ArgumentNullException

Параметр globalIds равен пустая ссылка (Nothing в Visual Basic).

SyncIdFormatMismatchException

Формат идентификаторов, указываемый параметром globalIds, не соответствует схеме форматов, заданной при инициализации метаданных реплики.

ItemMetadataNotFoundException

Элемент, присутствующий в списке globalIds, не найден в метаданных. Для реализации этого класса, которая возможна через класс SqlMetadataStore, все элементы, перечисленные до элемента, вызвавшего исключение, удалены из метаданных.

Замечания

Реализация этого класса, которая возможна через класс SqlMetadataStore, производит немедленное выполнение данной операции в хранилище. Если существует незавершенная явная транзакция, то операция будет выполнена в контексте этой транзакции и может быть подвергнута отказу, если эта транзакция ни зафиксирована, ни откачена.

NoteПримечание.

Этот метод пометки элемента в качестве отметки полного удаления является неверным. Чтобы пометить элемент в качестве отметки полного удаления, установите свойство ItemMetadata.IsDeleted в значение true. Поставщик пользуется этим методом в том случае, если ему необходимо прекратить отслеживание метаданных для элемента и полностью удалить этот элемент из хранилища, как это происходит при очистке отметок полного удаления.

См. также

Справочник

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