共用方式為

ReplicaMetadata.CreateItemMetadata 方法

  • 發行項

在衍生類別中覆寫時，會建立新的項目中繼資料物件，這些物件可用來將新的項目中繼資料項目加入到中繼資料存放區。

命名空間: Microsoft.Synchronization.MetadataStorage
組件: Microsoft.Synchronization.MetadataStorage (在 microsoft.synchronization.metadatastorage.dll)

語法

'宣告
Public MustOverride Function CreateItemMetadata ( _
    globalId As SyncId, _
    creationVersion As SyncVersion _
) As ItemMetadata
'用途
Dim instance As ReplicaMetadata
Dim globalId As SyncId
Dim creationVersion As SyncVersion
Dim returnValue As ItemMetadata

returnValue = instance.CreateItemMetadata(globalId, creationVersion)

public abstract ItemMetadata CreateItemMetadata (
    SyncId globalId,
    SyncVersion creationVersion
)

public:
virtual ItemMetadata^ CreateItemMetadata (
    SyncId^ globalId, 
    SyncVersion^ creationVersion
) abstract

public abstract ItemMetadata CreateItemMetadata (
    SyncId globalId, 
    SyncVersion creationVersion
)

public abstract function CreateItemMetadata (
    globalId : SyncId, 
    creationVersion : SyncVersion
) : ItemMetadata

參數

  • globalId
    要建立之項目的全域識別碼。此全域識別碼必須是唯一的。
  • creationVersion
    要與此項目產生關聯的建立版本。

傳回值

新建的項目中繼資料物件。

例外

例外狀況型別 條件

ObjectDisposedException

此物件已被處置，或是未正確初始化。

ArgumentNullException

globalId 或 creationVersion 是 null 參考 (在 Visual Basic 中為 Nothing)。

OutOfMemoryException

記憶體不足，無法建立項目中繼資料。

SyncIdFormatMismatchException

globalId 的格式不符合初始化此複寫中繼資料時所指定的格式。

備註

要等到呼叫 SaveItemMetadata 之後，此項目中繼資料才會儲存到中繼資料存放區。

範例

下列範例會建立項目的中繼資料、針對項目中的每個變更單位設定變更單位版本，並且針對項目的索引欄位設定自訂欄位值。

private ItemMetadata CreateContactMetadata(Contact contact, SyncId itemId, SyncVersion creationVersion,
    SyncVersion changeVersion)
{
    // Create the item by using the metadata storage service.
    ItemMetadata itemMeta = _ContactReplicaMetadata.CreateItemMetadata(itemId, creationVersion);

    // Set the version information for each change unit.
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.NameCU), changeVersion);
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.PhoneCU), changeVersion);
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.AddressCU), changeVersion);
    itemMeta.SetChangeUnitVersion(new SyncId((byte)Contact.ChangeUnitFields.BirthdateCU), changeVersion);

    // A unique index is defined for the combination of first name, last name, and phone number in order
    // to map between the item ID and the contact.
    // Set the field values for the index fields.
    itemMeta.SetCustomField(FirstNameField, contact.FirstName);
    itemMeta.SetCustomField(LastNameField, contact.LastName);
    itemMeta.SetCustomField(PhoneNumberField, contact.PhoneNumber);

    return itemMeta;
}

請參閱

參考

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