DataContractAttribute.Name Eigenschaft

Definition

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, set
Public Property Name As String

Eigenschaftswert

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.

Gilt für: