DataContractAttribute.Name DataContractAttribute.Name DataContractAttribute.Name DataContractAttribute.Name Property

Определение

Возвращает или задает имя для контракта данных типа.Gets or sets the name of the data contract for the type.

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

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

Локальное имя контракта данных.The local name of a data contract. Значение по умолчанию — это имя класса, к которому применяется атрибут.The default is the name of the class that the attribute is applied to.

Комментарии

Свойство Name используется для задания имени контракту данных, которое является именем типа в схеме XML.The Name property is used to give a name to a data contract, which is the name of the type in XML schema. Дополнительные сведения см. в разделе имена контрактов данных.For more information, see Data Contract Names.

По умолчанию имя контракта данных — это имя типа, к которому применяется атрибут DataContractAttribute.By default, the name of a data contract is the name of the type that the DataContractAttribute is applied to. Однако могут существовать причины изменить это имя по умолчанию.However, there may be reasons to change this default name. Одной из них может быть необходимость разрешить существующему типу обрабатывать данные, которые должны соответствовать существующему контракту данных.One reason is to allow an existing type to process data that must conform to an existing data contract. Например, существует тип Person, но для контракта данных, встроенного в схему XML, требуется, чтобы имя было Customer.For example, there exists a type named Person but the data contract, embodied in an XML schema, requires that the name be Customer. Контракт можно выполнить, задав значению свойства значение Customer.The contract can be satisfied by setting the property value to Customer.

Другой причиной может быть необходимость разрешить создание имен, которые недопустимы в качестве имени типа.A second reason is to allow the generation of names that are invalid as type names. Например, если для контракта данных требуется имя, не разрешенное в качестве имени типа, задайте значению свойства это запрещенное имя.For example, if a data contract demands a name that is not allowable as a type name, set the property value to that disallowed name. Например, строку "$value" нельзя использовать в качестве имени типа, но можно использовать как значение свойства Name.For instance, the string "$value" is disallowed as a type name but is allowed as a Name property value.

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