DataContractAttribute.Name Proprietà

Definizione

Spazio dei nomi:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.Primitives.dll

Source:

DataContractAttribute.cs

Ottiene o imposta il nome del contratto dati per il tipo.

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

Valore della proprietà

String

Nome locale di un contratto dati. Il valore predefinito è un nome della classe alla quale viene applicato l'attributo.

Commenti

La proprietà Name viene utilizzata per assegnare un nome a un contratto dati. Tale nome corrisponde al nome del tipo nello schema XML. Per altre informazioni, vedere Nomi dei contratti dati.

Per impostazione predefinita, il nome di un contratto dati è il nome del tipo al quale viene applicato l'attributo DataContractAttribute. Il nome predefinito può comunque essere modificato. Uno dei motivi per cui modificare il nome predefinito è quello di consentire a un tipo esistente di elaborare dati che devono essere conformi a un contratto dati esistente. Se, ad esempio, si dispone di un tipo denominato Person, ma il contratto dati incorporato in uno schema XML richiede invece che il nome sia Customer, per soddisfare i requisiti del contratto è necessario impostare il valore della proprietà su Customer.

Un altro motivo per cui modificare il nome predefinito è quello di consentire la generazione di nomi che non sono validi come nomi di tipo. Se, ad esempio, un contratto dati richiede un nome che non è consentito come nome di tipo, impostare il valore della proprietà sul nome non consentito. Ad esempio, la stringa "$value" non è consentita come nome di tipo ma è consentita come valore della proprietà Name.