Attribute zur Steuerung der Serialisierung von codiertem SOAP

  • Artikel

Das vom World Wide Web Consortium (W3C) 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 dem 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 Gewusst wie: Serialisieren eines Objekts als SOAP-codierter XML-Stream und Gewusst wie: Überschreiben von codierter SOAP-XML-Serialisierung.

Weitere Informationen zu Attributen finden Sie unter Attribute.

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 wird beim Serialisieren der Klasse, in dem sie bzw. es enthalten ist, 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