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 se používá k zadání názvu 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ázev typu, na který DataContractAttribute se použije. Může však 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ávat data, která musí být v souladu s existující smlouvou o datech. 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 povolit 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.