Método ReplicaMetadata.RemoveItemMetadata

Artigo
10/17/2009

Quando substituído em uma classe derivada, remove os metadados do item do repositório de metadados.

Namespace: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (em microsoft.synchronization.metadatastorage.dll)

Sintaxe

'Declaração
Public MustOverride Sub RemoveItemMetadata ( _
    globalIds As IEnumerable(Of SyncId) _
)
'Uso
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>
)

Parâmetros

globalIds
A coleção de IDs globais dos itens a serem removidos.

Exceções

Tipo de exceção	Condição
ObjectDisposedException	O objeto foi descartado ou não foi inicializado corretamente.
ArgumentNullException	globalIds é um referência nula (Nothing no Visual Basic).
SyncIdFormatMismatchException	O formato de uma ID em globalIds não corresponde ao esquema de formato especificado quando estes metadados da réplica foram inicializados.
ItemMetadataNotFoundException	Um item que está listado em globalIds não foi localizado nos metadados. Para a implementação desta classe que está disponível através de SqlMetadataStore, todos os itens que foram enumerados antes do item que provocou a exceção são removidos dos metadados.

Comentários

A implementação desta classe, que está disponível através de SqlMetadataStore, executa imediatamente esta operação no repositório. Se houver uma transação explícita pendente, a operação acontecerá dentro daquela transação e será revertida se a transação não for confirmada ou revertida.

Dica

Esta não é a forma correta de se marcar um item como uma marca de exclusão. Para marcar um item como uma marca de exclusão, defina ItemMetadata.IsDeleted como true. Um provedor usa este método quando deseja interromper o controle de metadados de um item e remover completamente o item do repositório, como durante a limpeza da marca de exclusão.

Consulte também

Referência

Classe ReplicaMetadata
Membros ReplicaMetadata
Namespace Microsoft.Synchronization.MetadataStorage

Compartilhar via