DataContractAttribute.Name Свойство

Определение

Возвращает или задает имя для контракта данных типа.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };
public string Name { get; set; }
public string? Name { get; set; }
member this.Name : string with get, set
Public Property Name As String

Значение свойства

Локальное имя контракта данных. Значение по умолчанию — это имя класса, к которому применяется атрибут.

Комментарии

Свойство Name используется для задания имени контракту данных, которое является именем типа в схеме XML. Дополнительные сведения см. в разделе Имена контрактов данных.

По умолчанию имя контракта данных — это имя типа, к которому применяется атрибут DataContractAttribute. Однако могут существовать причины изменить это имя по умолчанию. Одной из них может быть необходимость разрешить существующему типу обрабатывать данные, которые должны соответствовать существующему контракту данных. Например, существует тип Person, но для контракта данных, встроенного в схему XML, требуется, чтобы имя было Customer. Контракт можно выполнить, задав значению свойства значение Customer.

Другой причиной может быть необходимость разрешить создание имен, которые недопустимы в качестве имени типа. Например, если для контракта данных требуется имя, не разрешенное в качестве имени типа, задайте значению свойства это запрещенное имя. Например, строку "$value" нельзя использовать в качестве имени типа, но можно использовать как значение свойства Name.

Применяется к