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, setPublic Property Name As StringЗначение свойства
Локальное имя контракта данных. По умолчанию используется имя класса, к которому применяется атрибут.
Комментарии
Свойство Name используется для присвоения имени контракту данных, который является именем типа в схеме XML. Дополнительные сведения см. в разделе "Имена контрактов данных".
По умолчанию имя контракта данных — это имя типа, к которому DataContractAttribute применяется. Однако могут возникнуть причины изменения этого имени по умолчанию. Одной из причин является разрешение существующего типа обрабатывать данные, которые должны соответствовать существующему контракту данных. Например, существует тип с именем Person , но контракт данных, воплощенный в xml-схеме, требует, чтобы имя было Customer. Контракт может быть удовлетворен, задав для свойства значение Customer.
Вторая причина заключается в том, чтобы разрешить создание имен, недопустимых в качестве имен типов. Например, если контракт данных требует имя, которое не допускается в качестве имени типа, задайте для свойства значение этого запрещенного имени. Например, строка "$value" запрещена как имя типа, но разрешено Name в качестве значения свойства.
