DataContractAttribute.Name Propriedade

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 Propriedade

O nome local de um contrato de dados. O padrão é o nome da classe a que o atributo é aplicado.

Observações

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

Por defeito, o nome de um contrato de dados é o nome do tipo a que o DataContractAttribute é aplicado. No entanto, podem existir razões para mudar este nome padrão. Uma das razões é permitir que um tipo existente processe dados que devem estar em conformidade com um contrato de dados existente. Por exemplo, existe um tipo chamado Person mas o contrato de dados, incorporado num esquema XML, requer que o nome seja Customer. O contrato pode ser cumprido fixando o valor do imóvel em Customer.

Uma segunda razão é 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 é permitido como nome de tipo, defina o valor da propriedade para esse nome não permitido. Por exemplo, a cadeia "$value" não é permitida como nome de tipo, mas é permitida como Name valor de propriedade.