DataContractAttribute.Name 屬性

定義

命名空間:

System.Runtime.Serialization

組件:

System.Runtime.Serialization.Primitives.dll

組件:

System.Runtime.Serialization.dll

組件:

netstandard.dll

取得或設定型別的資料合約名稱。

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

public string Name { get; set; }

public string? Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

屬性值

String

資料合約的本機名稱。 預設為要套用屬性之類別的名稱。

備註

Name 屬性是用來指定資料合約的名稱，而這個名稱也就是在 XML 結構描述中的型別名稱。 如需詳細資訊，請參閱 資料合約名稱。

根據預設，資料合約的名稱就是要套用 DataContractAttribute 之型別的名稱。 但是，這個預設名稱可能會因為某些原因而需要變更。 其中一個原因是要讓現有型別可以處理必須符合現有資料合約的資料。 例如，有一個名為 Person 的型別，但是包含在 XML 結構描述中的資料合約所要求的名稱卻是 Customer。 這時只要將屬性值設定為 Customer 就可以滿足該合約。

第二個原因是為了能夠產生不允許當做型別名稱的名稱。 例如，如果資料合約需要的名稱不允許當做型別名稱，此時可以將屬性值設定成那個不被允許的名稱。 例如，字串 "$value" 不允許當做型別名稱，但是可以當做 Name 屬性值。