DataContractAttribute.Name Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Namen des Datenvertrags für den Typ ab oder legt ihn fest.
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 StringEigenschaftswert
Der lokale Name eines Datenvertrags. Der Standardwert ist der Name der Klasse, auf die das Attribut angewendet wird.
Hinweise
Die Name Eigenschaft wird verwendet, um einem Datenvertrag einen Namen zuzuweisen, bei dem es sich um den Namen des Typs im XML-Schema handelt. Weitere Informationen finden Sie unter "Datenvertragsnamen".
Standardmäßig ist der Name eines Datenvertrags der Name des Typs, auf den die DataContractAttribute Anwendung angewendet wird. Es kann jedoch Gründe geben, diesen Standardnamen zu ändern. Ein Grund besteht darin, einem vorhandenen Typ die Verarbeitung von Daten zu ermöglichen, die einem vorhandenen Datenvertrag entsprechen müssen. Beispielsweise gibt es einen Typ namens, Person aber der Datenvertrag, der in einem XML-Schema verkörpert ist, erfordert, dass der Name sein muss Customer. Der Vertrag kann durch Festlegen des Eigenschaftswerts auf Customer.
Ein zweiter Grund besteht darin, die Generierung von Namen zuzulassen, die als Typnamen ungültig sind. Wenn beispielsweise ein Datenvertrag einen Namen erfordert, der nicht als Typname zulässig ist, legen Sie den Eigenschaftswert auf diesen unzulässigen Namen fest. Beispielsweise ist die Zeichenfolge "$value" als Typname unzulässig, ist aber als Name Eigenschaftswert zulässig.
