Freigeben über


Attribute zur Steuerung der Serialisierung von codiertem SOAP

Das vom World Wide Web Consortium (www.w3.org) herausgegebene Dokument mit dem Titel "Simple Object Access Protocol (SOAP) 1.1" enthält einen optionalen Abschnitt (Abschnitt 5), in dem die Codierung von SOAP-Parametern beschrieben wird. Um Abschnitt 5 dieser Spezifikation zu entsprechen, müssen Sie spezielle Attribute verwenden, die im System.Xml.Serialization-Namespace enthalten sind. Wenden Sie diese Attribute auf die entsprechenden Klassen und Member der Klassen an, und verwenden Sie dann XmlSerializer, um Instanzen dieser Klasse oder Klassen zu serialisieren.

In der folgenden Tabelle sind die Attribute, ihr Anwendungsbereich und ihre Funktion aufgeführt. Weitere Informationen zum Steuern der XML-Serialisierung mithilfe dieser Attribute finden Sie unter Vorgehensweise: Serialisieren eines Objekts als SOAP-codierter XML-Stream und Vorgehensweise: Überschreiben von codierter SOAP-XML-Serialisierung.

Weitere Informationen zu Attributen finden Sie unter Extending Metadata Using Attributes.

Attribut Betrifft Bedeutung

SoapAttributeAttribute

Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert.

Der Klassenmember wird als XML-Attribut serialisiert.

SoapElementAttribute

Öffentliches Feld, Eigenschaft, Parameter oder Rückgabewert.

Die Klasse wird als XML-Element serialisiert.

SoapEnumAttribute

Öffentliches Feld, das ein Enumerationsbezeichner ist.

Der Elementname eines Enumerationsmembers.

SoapIgnoreAttribute

Öffentliche Eigenschaften und Felder.

Die Eigenschaft oder das Feld sollte beim Serialisieren der Klasse, in dem sie bzw. es enthalten ist, ignoriert werden.

SoapIncludeAttribute

Öffentliche abgeleitete Klassendeklarationen und öffentliche Methoden für WSDL-Dokumente (Web Services Description Language).

Der Typ wird beim Generieren von Schemas eingeschlossen (und daher bei der Serialisierung erkannt).

SoapTypeAttribute

Deklarationen öffentlicher Klassen.

Die Klasse sollte als XML-Typ serialisiert werden.

Siehe auch

Aufgaben

Vorgehensweise: Serialisieren eines Objekts als SOAP-codierter XML-Stream
Vorgehensweise: Überschreiben von codierter SOAP-XML-Serialisierung
Vorgehensweise: Serialisieren eines Objekts
Vorgehensweise: Deserialisieren eines Objekts

Verweis

XmlSerializer

Weitere Ressourcen

XML- und SOAP-Serialisierung
Extending Metadata Using Attributes