DataContractAttribute.Name Właściwość

Definicja

Pobiera lub ustawia nazwę kontraktu danych dla typu.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; }
public string? Name { get; set; }
member this.Name : string with get, set
Public Property Name As String

Wartość właściwości

String

Nazwa lokalna kontraktu danych.The local name of a data contract. Wartość domyślna to nazwa klasy, do której zastosowano atrybut.The default is the name of the class that the attribute is applied to.

Uwagi

NameWłaściwość służy do nadawania nazwy do kontraktu danych, który jest nazwą typu w schemacie XML.The Name property is used to give a name to a data contract, which is the name of the type in XML schema. Aby uzyskać więcej informacji, zobacz nazwy kontraktów danych.For more information, see Data Contract Names.

Domyślnie nazwą kontraktu danych jest nazwa typu, DataContractAttribute do którego jest stosowana.By default, the name of a data contract is the name of the type that the DataContractAttribute is applied to. Jednak mogą istnieć powody zmiany tej nazwy domyślnej.However, there may be reasons to change this default name. Jedną z przyczyn jest umożliwienie istniejącemu typowi przetwarzania danych, które muszą być zgodne z istniejącym kontraktem danych.One reason is to allow an existing type to process data that must conform to an existing data contract. Na przykład istnieje typ o nazwie Person , ale kontrakt danych zawarty w schemacie XML wymaga, aby nazwa była Customer .For example, there exists a type named Person but the data contract, embodied in an XML schema, requires that the name be Customer. Umowę można spełnić, ustawiając wartość właściwości na Customer .The contract can be satisfied by setting the property value to Customer.

Drugim powodem jest umożliwienie generacji nazw, które są nieprawidłowe jako nazwy typów.A second reason is to allow the generation of names that are invalid as type names. Na przykład jeśli kontrakt danych wymaga nazwy, która nie jest dozwolona jako nazwa typu, ustaw wartość właściwości na tę niedozwoloną nazwę.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. Na przykład ciąg "$value" jest niedozwolony jako nazwa typu, ale jest dozwolony jako Name wartość właściwości.For instance, the string "$value" is disallowed as a type name but is allowed as a Name property value.

Dotyczy