DataContractAttribute.Name Propiedad

Definición

Espacio de nombres:

System.Runtime.Serialization

Ensamblado:

System.Runtime.Serialization.Primitives.dll

Source:

DataContractAttribute.cs

Obtiene o establece el nombre del contrato de datos para el tipo.

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

String

El nombre local del contrato de datos. El valor predeterminado es el nombre de la clase a la que se aplica el atributo.

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. Para obtener más información, vea Nombres de contrato de datos.

De forma predeterminada, el nombre de un contrato de datos es el nombre del tipo al que se aplica DataContractAttribute. Sin embargo, puede haber razones para cambiar este nombre predeterminado. Una razón es permitir que un tipo existente procese datos que deben ajustarse a un contrato de datos existentes. Por ejemplo, existe un tipo denominado Person pero el contrato de datos, contenido en un esquema XML, solicita que el nombre sea Customer. El contrato se puede satisfacer estableciendo el valor de propiedad en Customer.

Una segunda razón es permitir la generación de nombres que no son válidos como nombres de tipo. 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. Por ejemplo, la cadena "$valor" se deniega como nombre de tipo pero se permite como valor de la propiedad Name.