SoapIncludeAttribute Klasse

Definition

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Source:

SoapIncludeAttribute.cs

Ermöglicht dem XmlSerializer das Erkennen eines Typs beim Serialisieren oder Deserialisieren eines Objekts als codiertes SOAP-XML.

public ref class SoapIncludeAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
    inherit Attribute

Public Class SoapIncludeAttribute
Inherits Attribute

Vererbung

Object

Attribute

SoapIncludeAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird zweimal SoapIncludeAttribute auf eine XML-Webdienstmethode angewendet. Die Methode gibt ein Objekt vom Typ Vehicle (eine Basisklasse) zurück. Ermöglicht SoapIncludeAttribute der -Methode das Zurückgeben von Instanzen von Klassen, die von der Vehicle -Klasse abgeleitet sind.

Hinweise

Die SoapIncludeAttribute -Klasse gehört zu einer Familie von Attributen, die steuern, wie ein XmlSerializer Objekt als codiertes SOAP-XML serialisiert oder deserialisiert wird. Der resultierende XML-Code entspricht Abschnitt 5 des Dokuments des World Wide Web Consortium, SOAP 1.1 (Simple Object Access Protocol). Eine vollständige Liste ähnlicher Attribute finden Sie unter Attribute, die die codierte SOAP-Serialisierung steuern.

Um ein Objekt als codierte SOAP-Nachricht zu serialisieren, müssen Sie die XmlSerializer mithilfe einer XmlTypeMapping mit der ImportTypeMapping -Methode der SoapReflectionImporter -Klasse erstellten erstellen.

Geben Sie beim Anwenden von die SoapIncludeAttributeType der abgeleiteten Klasse an. Wenn die XmlSerializer -Klasse Objekte serialisiert, die sowohl die Basis- als auch die abgeleitete Klasse enthalten, können beide Objekttypen erkannt werden.

Sie können die SoapIncludeAttribute verwenden, um abgeleitete Klassen in Dienstbeschreibungsdokumente einzuschließen, die in der Web Services Description Language (WSDL) geschrieben sind. Wenn beispielsweise eine -Methode einen Objectzurückgibt, wenden Sie den SoapIncludeAttribute auf die -Methode an, und geben Sie die tatsächlichen Typen an, die zurückgegeben werden sollen.

Weitere Informationen zu WSDL finden Sie unter World Wide Web Consortium specification, Web Services Description Language (WSDL) 1.1.

Weitere Informationen zur Verwendung von Attributen finden Sie unter Attribute.

Konstruktoren

SoapIncludeAttribute(Type)

Initialisiert mithilfe des angegebenen Typs eine neue Instanz der SoapIncludeAttribute-Klasse.

Eigenschaften

Type	Ruft den Typ des Objekts ab, der bei der Serialisierung oder Deserialisierung eines Objekts verwendet werden soll, oder legt diesen fest.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)