Freigeben über


Attribute für die 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" (nur auf Englisch verfügbar) 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 die XmlSerializer-Klasse, um Instanzen der Klasse oder Klassen zu serialisieren.

In der folgenden Tabelle sind die Attribute, ihr Anwendungsbereich und ihre Funktion aufgeführt. Weitere Informationen zur Verwendung dieser Attribute bei der Steuerung der XML-Serialisierung finden Sie unter Generieren von SOAP-Meldungen mit der XML-Serialisierung.

Weitere Informationen zu Attributen finden Sie unter Erweitern von Metadaten mit Hilfe von Attributen.

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. Der Klassenmember wird als XML-Element serialisiert.
SoapEnumAttribute Öffentliches Feld, das ein Enumerationsbezeichner ist. Der Membername eines Enumerationsmembers.
SoapIgnoreAttribute Öffentliche Eigenschaften und Felder. Die Eigenschaft oder das Feld wird beim Serialisieren der enthaltenden Klasse ignoriert.
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 wird als XML-Typ serialisiert.

Siehe auch

XML- und SOAP-Serialisierung | Generieren von SOAP-Meldungen mit der XML-Serialisierung | Erweitern von Metadaten mit Hilfe von Attributen | XmlSerializer