DataContractAttribute.Name 屬性

定義

命名空間:

System.Runtime.Serialization

組件:

netstandard.dll, System.Runtime.Serialization.Primitives.dll

來源:

DataContractAttribute.cs

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

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

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