DataContractAttribute.Name Proprietà

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

Valore della proprietà

Nome locale di un contratto dati. Il valore predefinito è il nome della classe a cui viene applicato l'attributo.

Commenti

La Name proprietà viene utilizzata per assegnare un nome a un contratto dati, ovvero il nome del tipo in XML Schema. Per altre informazioni, vedere Nomi dei contratti dati.

Per impostazione predefinita, il nome di un contratto dati è il nome del tipo a cui viene applicato .DataContractAttribute Tuttavia, potrebbero esserci motivi per modificare questo nome predefinito. Un motivo è consentire a un tipo esistente di elaborare i dati che devono essere conformi a un contratto dati esistente. Esiste, ad esempio, un tipo denominato Person ma il contratto dati, incorporato in un XML Schema, richiede che il nome sia Customer. Il contratto può essere soddisfatto impostando il valore della proprietà su Customer.

Un secondo motivo consiste nell'consentire la generazione di nomi non validi come nomi di tipo. Ad esempio, se un contratto dati richiede un nome non consentito come nome di tipo, impostare il valore della proprietà su tale nome non consentito. Ad esempio, la stringa "$value" non è consentita come nome di tipo, ma è consentita come valore della Name proprietà.