DataContractAttribute.Name Propriedade

Definição

Namespace:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.Primitives.dll

Assembly:

System.Runtime.Serialization.dll

Assembly:

netstandard.dll

Obtém ou define o nome do contrato de dados para o tipo.

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

Valor da propriedade

String

O nome local de um contrato de dados. O padrão é o nome da classe ao qual o atributo foi aplicado.

Comentários

A Name propriedade é usada para dar um nome a um contrato de dados, que é o nome do tipo no esquema XML. Para obter mais informações, consulte Nomes de Contrato de Dados.

Por padrão, o nome de um contrato de dados é o nome do tipo ao qual ele DataContractAttribute é aplicado. No entanto, pode haver motivos para alterar esse nome padrão. Um dos motivos é permitir que um tipo existente processe dados que devem estar em conformidade com um contrato de dados existente. Por exemplo, existe um tipo nomeado Person , mas o contrato de dados, incorporado em um esquema XML, requer que o nome seja Customer. O contrato pode ser atendido definindo o valor da propriedade como Customer.

Um segundo motivo é permitir a geração de nomes inválidos como nomes de tipo. Por exemplo, se um contrato de dados exigir um nome que não seja permitido como um nome de tipo, defina o valor da propriedade como esse nome não permitido. Por exemplo, a cadeia de caracteres "$value" não é permitida como um nome de tipo, mas é permitida como um valor de Name propriedade.