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
abstract RemoveItemMetadata :
globalIds:IEnumerable<SyncId> -> unit
public abstract function RemoveItemMetadata(
globalIds : IEnumerable<SyncId>
)
參數
- globalIds
型別：System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'SyncId> ) > ) >
要移除之項目的全域識別碼集合。
例外
| 例外狀況 | 條件 |
|---|---|
| ObjectDisposedException | 此物件已被處置，或是未正確初始化。 |
| ArgumentNullException | globalIds 是 null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) 。 |
| SyncIdFormatMismatchException | globalIds 中的識別碼格式不符合初始化這個複寫中繼資料時所指定的格式結構描述。 |
| ItemMetadataNotFoundException | 在中繼資料內找不到 globalIds 中所列的項目。為了實作可透過 SqlMetadataStore 來取得的這個類別，列舉在造成此例外狀況之項目之前的所有項目都會從中繼資料內移除。 |
備註
透過 SqlMetadataStore 取得之這個類別的實作，會立即在存放區上執行這個作業。如果有待處理的明確交易，此作業將會發生在這個交易內，而且如果此交易未認可或是已復原，就會復原此作業。
注意
這不是將項目標示為標記的正確方式。若要將項目標示為標記，請將 ItemMetadata..::..IsDeleted 設定為 true。當提供者想要停止追蹤項目的中繼資料，而且想要從存放區中完全移除此項目 (例如在標記清除期間) 時，就會使用這個方法。