共用方式為


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

此項目是新的項目,而且此識別碼已經存在於中繼資料存放區中,或者此識別碼無效。

備註

必須呼叫這個方法,才能將 ItemMetadata 屬性變更儲存到中繼資料存放區。如果 ItemMetadata 屬性已變更,而且此物件被終結而未呼叫這個方法,這些變更將會遺失。

我們建議您在對應的變更已儲存到項目存放區之後,最好呼叫這個方法來儲存中繼資料變更。如此可幫助您確保在資料更新失敗時,將不會變更中繼資料。

可透過 SqlMetadataStore 來取得之這個類別的實作,會在呼叫這個方法之前所啟動的交易內容中執行更新。

實作器注意事項: 只有當中繼資料存放區成功認可所有屬性變更時,這個方法才會成功。不是必須認可所有的屬性變更,就是完全不認可。 如果中繼資料存放區支援交易,這個方法必須在該交易內容中,將它的變更套用到中繼資料存放區。

請參閱

參考

ReplicaMetadata 類別
ReplicaMetadata 成員
Microsoft.Synchronization.MetadataStorage 命名空間