DataContractAttribute.Name Vlastnost

Definice

Obor názvů:

System.Runtime.Serialization

Sestavení:

System.Runtime.Serialization.Primitives.dll

Zdroj:

DataContractAttribute.cs

Získá nebo nastaví název kontraktu dat 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í je název třídy, na kterou je atribut použit.

Poznámky

Vlastnost Name slouží k pojmenování kontraktu dat, což je název typu ve schématu XML. Další informace najdete v tématu Názvy kontraktů dat.

Ve výchozím nastavení je název kontraktu dat názvem typu, na DataContractAttribute který se použije. Může ale existovat důvod ke změně tohoto výchozího názvu. Jedním z důvodů je umožnit existujícímu typu zpracování dat, která musí odpovídat existujícímu kontraktu na data. Existuje například typ s názvem Person , ale kontrakt dat, který je součástí schématu XML, vyžaduje, aby název byl Customer. Smlouvu 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 datový kontrakt vyž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.