DataContractAttribute.Name Egenskap

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

Egenskapsvärde

Det lokala namnet på ett datakontrakt. Standardvärdet är namnet på den klass som attributet tillämpas på.

Kommentarer

Egenskapen Name används för att ge ett namn till ett datakontrakt, vilket är namnet på typen i XML-schemat. Mer information finns i Namn på datakontrakt.

Som standard är namnet på ett datakontrakt namnet på den typ som DataContractAttribute tillämpas på. Det kan dock finnas skäl att ändra det här standardnamnet. En orsak är att tillåta att en befintlig typ bearbetar data som måste överensstämma med ett befintligt datakontrakt. Det finns till exempel en typ med namnet Person , men datakontraktet, som ingår i ett XML-schema, kräver att namnet är Customer. Kontraktet kan uppfyllas genom att ange egenskapsvärdet till Customer.

En andra orsak är att tillåta generering av namn som är ogiltiga som typnamn. Om ett datakontrakt till exempel kräver ett namn som inte kan tillåtas som ett typnamn anger du egenskapsvärdet till det otillåtna namnet. Strängen "$value" tillåts till exempel inte som ett typnamn men tillåts som ett Name egenskapsvärde.