CustomFieldDefinition 類別

表示可用來識別中繼資料存放區中之項目，或是用來儲存項目或變更單位之版本相關資訊的欄位。

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

語法

'宣告
Public Class CustomFieldDefinition
'用途
Dim instance As CustomFieldDefinition

public class CustomFieldDefinition

public ref class CustomFieldDefinition

public class CustomFieldDefinition

public class CustomFieldDefinition

備註

自訂欄位是在中繼資料存放區中由整數所識別的欄位。如果應用程式需要一個或多個欄位的易記名稱，它應該將此整數對應到名稱。針對兩個理由所定義的自訂欄位：為了識別項目，並提供有關這些項目的版本資訊。版本欄位可讓 Sync Framework 判斷某個項目或變更單位是否已變更。如需簡單提供者中繼資料的詳細資訊，請參閱管理簡單提供者的中繼資料。

自訂欄位可以是下列資料類型。若為固定長度的類型，請使用兩個參數的建構函式 CustomFieldDefinition。若為變動長度的類型，請使用三個參數的建構函式 CustomFieldDefinition。

類型	建構函式
Byte	CustomFieldDefinition
Byte[]	CustomFieldDefinition
Guid	CustomFieldDefinition
String	CustomFieldDefinition
UInt16	CustomFieldDefinition
UInt32	CustomFieldDefinition
UInt64	CustomFieldDefinition

範例

下列程式碼範例提供 ItemMetadataSchema 物件的輸入。範例程式碼中的常數定義項目存放區中每一資料行的整數值。這些值是在建立自訂欄位定義和 ItemMetadataSchema 物件的識別規則時使用。若要在完整應用程式的內容中檢視這段程式碼，請參閱 Sync Framework SDK 及 Code Gallery 中的 "Sync101 using Simple Sync Provider" 應用程式。

public const uint CUSTOM_FIELD_ID = 1;
public const uint CUSTOM_FIELD_TIMESTAMP = 2;

public override ItemMetadataSchema MetadataSchema
{
    get
    {
        CustomFieldDefinition[] customFields = new CustomFieldDefinition[2];
        customFields[0] = new CustomFieldDefinition(CUSTOM_FIELD_ID, typeof(ulong));
        customFields[1] = new CustomFieldDefinition(CUSTOM_FIELD_TIMESTAMP, typeof(ulong));

        IdentityRule[] identityRule = new IdentityRule[1];
        identityRule[0] = new IdentityRule(new uint[] { CUSTOM_FIELD_ID });

        return new ItemMetadataSchema(customFields, identityRule);
    }
}

Public Const CUSTOM_FIELD_ID As UInteger = 1
Public Const CUSTOM_FIELD_TIMESTAMP As UInteger = 2
Public Overrides ReadOnly Property MetadataSchema() As ItemMetadataSchema
    Get
        Dim customFields As CustomFieldDefinition() = New CustomFieldDefinition(1) {}
        customFields(0) = New CustomFieldDefinition(CUSTOM_FIELD_ID, GetType(ULong))
        customFields(1) = New CustomFieldDefinition(CUSTOM_FIELD_TIMESTAMP, GetType(ULong))

        Dim identityRule As IdentityRule() = New IdentityRule(0) {}
        identityRule(0) = New IdentityRule(New UInteger() {CUSTOM_FIELD_ID})

        Return New ItemMetadataSchema(customFields, identityRule)
    End Get
End Property

繼承階層

System.Object
  Microsoft.Synchronization.SimpleProviders.CustomFieldDefinition

執行緒安全性

任何公用靜態 (共用 在 Visual Basic) 此型別的成員具備執行緒安全。不保證任何執行個體成員安全執行緒。

請參閱

參考

CustomFieldDefinition 成員
Microsoft.Synchronization.SimpleProviders 命名空間