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 des Datenvertrags. Der Standardwert ist der Name der Klasse, auf den das Attribut angewendet wird.
Hinweise
Die Name-Eigenschaft wird verwendet, um einem Datenvertrag einen Namen zu geben, der dem Namen des Typs im XML-Schema entspricht. Weitere Informationen finden Sie unter Namen des Datenvertrags.
Der Name des Datenvertrags ist standardmäßig der Name des Typs, auf den der DataContractAttribute angewendet wird. Es kann jedoch Gründe dafür geben, den Standardnamen zu ändern. Ein solcher Grund liegt vor, wenn für einen vorhandenen Typ zugelassen werden soll, dass dieser Daten verarbeitet, die einem vorhandenen Datenvertrag entsprechen müssen. Beispiel: Ein Typ mit dem Namen Person ist vorhanden, doch der in einem XML-Schema enthaltene Datenvertrag erfordert, dass der Name Customer lautet. Der Vertrag kann eingehalten werden, indem der Eigenschaftswert auf Customer gesetzt wird.
Ein zweiter Grund liegt vor, wenn die Generierung von Namen zugelassen werden soll, die als Typnamen ungültig sind. Beispiel: Wenn ein Datenvertrag einen Namen erfordert, der als Typname nicht zulässig ist, muss der Eigenschaftswert auf diesen unzulässigen Namen festgelegt werden. Beispielsweise ist die Zeichenfolge '$value' als Typname unzulässig, aber als Name-Eigenschaftswert erlaubt.
