ReplicaMetadata.SaveItemMetadata 方法

  • 项目

在派生类中重写时，将项元数据属性变更保存到元数据存储区中。

命名空间: 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 为 null 引用（在 Visual Basic 中为 Nothing）。

KeyUniquenessException

该项为一个新项，元数据存储区中已存在该 ID，或该 ID 无效。

备注

必须调用此方法来将 ItemMetadata 属性变更保存到元数据存储区。如果没有调用此方法而 ItemMetadata 属性发生变更并且对象损坏，则这些变更将会丢失。

建议在将相应变更保存到项存储区后，再调用此方法保存元数据变更。这有助于确保在数据更新失败的情况下不会变更元数据。

可通过 SqlMetadataStore 获得的此类的实现在调用此方法前启动的事务的上下文中执行更新。

实施者注意事项： 此方法仅在所有属性变更均已成功提交到元数据存储区后才会成功。或者所有属性变更均已提交，或者任何属性变更均未提交。 如果元数据存储区支持事务，则此方法必须在事务的上下文中将其变更应用到元数据存储区。

请参阅

参考

ReplicaMetadata 类
ReplicaMetadata 成员
Microsoft.Synchronization.MetadataStorage 命名空间