DataContractAttribute.Name Propriété

Définition

Espace de noms:

System.Runtime.Serialization

Assemblys:

netstandard.dll, System.Runtime.Serialization.Primitives.dll

Source:

DataContractAttribute.cs

Obtient ou définit le nom du contrat de données pour le 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

Valeur de propriété

String

Nom local d’un contrat de données. La valeur par défaut est le nom de la classe à laquelle l’attribut est appliqué.

Remarques

La Name propriété est utilisée pour donner un nom à un contrat de données, qui est le nom du type dans le schéma XML. Pour plus d’informations, consultez Noms des contrats de données.

Par défaut, le nom d’un contrat de données est le nom du type auquel il DataContractAttribute est appliqué. Toutefois, il peut y avoir des raisons de modifier ce nom par défaut. L’une des raisons est d’autoriser un type existant à traiter les données qui doivent être conformes à un contrat de données existant. Par exemple, il existe un type nommé Person mais le contrat de données, incorporé dans un schéma XML, exige que le nom soit Customer. Le contrat peut être satisfait en définissant la valeur de la propriété sur Customer.

Une deuxième raison consiste à autoriser la génération de noms non valides en tant que noms de types. Par exemple, si un contrat de données exige un nom qui n’est pas autorisé comme nom de type, définissez la valeur de propriété sur ce nom non autorisé. Par exemple, la chaîne « $value » n’est pas autorisée en tant que nom de type, mais elle est autorisée en tant que Name valeur de propriété.