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.