DataContractAttribute.Name Propiedad

Definición

Obtiene o establece el nombre del contrato de datos para el tipo.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

Valor de propiedad

El nombre local del contrato de datos.The local name of a data contract. El valor predeterminado es el nombre de la clase a la que se aplica el atributo.The default is the name of the class that the attribute is applied to.

Comentarios

La propiedad Name se usa para dar un nombre a un contrato de datos, cuyo nombre también es el del tipo del esquema XML.The Name property is used to give a name to a data contract, which is the name of the type in XML schema. Para obtener más información, vea nombres de contratos de datos.For more information, see Data Contract Names.

De forma predeterminada, el nombre de un contrato de datos es el nombre del tipo al que se aplica DataContractAttribute.By default, the name of a data contract is the name of the type that the DataContractAttribute is applied to. Sin embargo, puede haber razones para cambiar este nombre predeterminado.However, there may be reasons to change this default name. Una razón es permitir que un tipo existente procese datos que deben ajustarse a un contrato de datos existentes.One reason is to allow an existing type to process data that must conform to an existing data contract. Por ejemplo, existe un tipo denominado Person pero el contrato de datos, contenido en un esquema XML, solicita que el nombre sea Customer.For example, there exists a type named Person but the data contract, embodied in an XML schema, requires that the name be Customer. El contrato se puede satisfacer estableciendo el valor de propiedad en Customer.The contract can be satisfied by setting the property value to Customer.

Una segunda razón es permitir la generación de nombres que no son válidos como nombres de tipo.A second reason is to allow the generation of names that are invalid as type names. Por ejemplo, si un contrato de datos exige un nombre que no es permitido como nombre de tipo, establezca el valor de propiedad en dicho nombre denegado.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. Por ejemplo, la cadena "$valor" se deniega como nombre de tipo pero se permite como valor de la propiedad Name.For instance, the string "$value" is disallowed as a type name but is allowed as a Name property value.

Se aplica a