DataContractAttribute.Name Vlastnost

Definice

Obor názvů:

System.Runtime.Serialization

Sestavení:

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

Zdroj:

DataContractAttribute.cs

Získá nebo nastaví název datového kontraktu pro typ.

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

Hodnota vlastnosti

String

Místní název kontraktu dat. Výchozí hodnota je název třídy, na kterou je atribut použit.

Poznámky

Vlastnost Name se používá k zadání názvu datového kontraktu, což je název typu ve schématu XML. Další informace naleznete v tématu Názvy kontraktů dat.

Ve výchozím nastavení je název datového kontraktu název typu, na který se DataContractAttribute vztahuje. Tento výchozí název se ale může změnit. Jedním z důvodů je umožnit stávajícímu typu zpracovávat data, která musí odpovídat existujícímu kontraktu dat. Existuje například typ pojmenovaný Person , ale kontrakt dat, který je ztělesněný ve schématu XML, vyžaduje, aby název byl Customer. Kontrakt lze splnit nastavením hodnoty vlastnosti na Customerhodnotu .

Druhým důvodem je umožnit generování názvů, které jsou neplatné jako názvy typů. Pokud například kontrakt dat požaduje název, který není povolený jako název typu, nastavte hodnotu vlastnosti na tento nepovolený název. Například řetězec "$value" je zakázán jako název typu, ale je povolen jako Name hodnota vlastnosti.