DataContractAttribute.Name Właściwość

Definicja

Przestrzeń nazw:

System.Runtime.Serialization

Zestaw:

System.Runtime.Serialization.Primitives.dll

Źródło:

DataContractAttribute.cs

Pobiera lub ustawia nazwę kontraktu danych dla typu.

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

Wartość właściwości

String

Lokalna nazwa kontraktu danych. Wartość domyślna to nazwa klasy, do którego jest stosowany atrybut.

Uwagi

Właściwość Name służy do nadania nazwy kontraktowi danych, który jest nazwą typu w schemacie XML. Aby uzyskać więcej informacji, zobacz Nazwy kontraktów danych.

Domyślnie nazwa kontraktu danych to nazwa typu, do którego DataContractAttribute jest stosowany. Jednak mogą wystąpić powody zmiany tej nazwy domyślnej. Jednym z powodów jest umożliwienie istniejącemu typowi przetwarzania danych, które muszą być zgodne z istniejącym kontraktem danych. Na przykład istnieje typ o nazwie Person , ale kontrakt danych, wbudowany w schemat XML, wymaga nazwy Customer. Kontrakt można spełnić, ustawiając wartość właściwości na Customer.

Drugim powodem jest umożliwienie generowania nazw, które są nieprawidłowe jako nazwy typów. Jeśli na przykład kontrakt danych wymaga nazwy, która nie jest dozwolona jako nazwa typu, ustaw wartość właściwości na tę niedozwoloną nazwę. Na przykład ciąg "$value" jest niedozwolony jako nazwa typu, ale jest dozwolony jako Name wartość właściwości.