DataContractAttribute.Name Propriété

Définition

Espace de noms:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.Primitives.dll

Assembly:

System.Runtime.Serialization.dll

Assembly:

netstandard.dll

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; }

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 est appliqué l'attribut.

Remarques

La propriété Name permet de donner un nom à un contrat de données, lequel correspond au 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 à qui le DataContractAttribute est appliqué. Toutefois, il peut exister des raisons de modifier ce nom par défaut. Une des raisons est de permettre à un type existant de traiter des données qui doivent se conformer à un contrat de données existant. Par exemple, s'il existe un type nommé Person mais que le contrat de données inclus dans un schéma XML requiert que le nom soit Customer, le contrat peut être rempli en affectant Customer à la valeur de propriété.

Une deuxième raison est d'autoriser la génération de noms qui ne sont pas valides en tant que noms de type. Par exemple, si un contrat de données requiert un nom qui n'est pas autorisé comme nom de type, affectez ce nom non autorisé à la valeur de propriété. Par exemple, la chaîne "$value" n'est pas autorisée comme nom de type mais elle est autorisée comme valeur de propriété Name.