DataContractAttribute.Name Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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; }public string? Name { get; set; }member this.Name : string with get, setPublic Property Name As StringValore della proprietà
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.
