Метод ReplicaMetadata.SaveItemMetadata

Статья
10/17/2009

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

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

Синтаксис

'Декларация
Public MustOverride Sub SaveItemMetadata ( _
    itemMetadata As ItemMetadata _
)
'Применение
Dim instance As ReplicaMetadata
Dim itemMetadata As ItemMetadata

instance.SaveItemMetadata(itemMetadata)

public abstract void SaveItemMetadata (
    ItemMetadata itemMetadata
)

public:
virtual void SaveItemMetadata (
    ItemMetadata^ itemMetadata
) abstract

public abstract void SaveItemMetadata (
    ItemMetadata itemMetadata
)

public abstract function SaveItemMetadata (
    itemMetadata : ItemMetadata
)

Параметры

itemMetadata
Метаданные элемента, которые должны быть сохранены в хранилище метаданных.

Исключения

Тип исключения	Условие
ObjectDisposedException	Объект удален или неправильно инициализирован.
ArgumentNullException	Параметр itemMetadata равен пустая ссылка (Nothing в Visual Basic).
KeyUniquenessException	Элемент является новым, а идентификатор уже существует в хранилище метаданных, либо идентификатор является недопустимым.

Замечания

Этот метод вызывается для того, чтобы сохранить изменения свойств ItemMetadata в хранилище метаданных. Если свойства объекта ItemMetadata были изменены, а объект удален без вызова данного метода, то все изменения будут утеряны.

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

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

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

См. также

Справочник

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

Поделиться через