Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

SoapIncludeAttribute-Klasse

 

Veröffentlicht: Oktober 2016

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

Namespace:   System.Xml.Serialization
Assembly:  System.Xml (in System.Xml.dll)

System.Object
  System.Attribute
    System.Xml.Serialization.SoapIncludeAttribute

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

NameBeschreibung
System_CAPS_pubmethodSoapIncludeAttribute(Type)

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

NameBeschreibung
System_CAPS_pubpropertyType

Ruft ab oder legt den Typ des Objekts, das beim Serialisieren oder Deserialisieren eines Objekts fest.

System_CAPS_pubpropertyTypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.(Geerbt von „Attribute“.)

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodGetHashCode()

Gibt den Hashcode für diese Instanz zurück.(Geerbt von „Attribute“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodIsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodMatch(Object)

Ruft beim Überschreiben in einer abgeleiteten Klasse gibt einen Wert, der angibt, ob diese Instanz gleich ein angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.(Geerbt von „Attribute“.)

Die SoapIncludeAttribute -Klasse gehört zu einer Familie von Attributen, die steuert, wie die XmlSerializer Serialisieren bzw. Deserialisieren eines Objekts als codiertes SOAP-XML. Das resultierende XML entspricht Abschnitt 5 des World Wide Web Consortium (www.w3.org) Dokuments "Simple Object Access Protocol (SOAP) 1.1". Eine vollständige Liste ähnlicher Attribute finden Sie unter Attribute zur Steuerung der Serialisierung von codiertem SOAP.

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

Beim Anwenden der SoapIncludeAttribute, geben Sie die Type der abgeleiteten Klasse. Wenn die XmlSerializer serialisiert Objekte, die Basis- und abgeleiteten Klassen enthalten beide Objekttypen erkannt.

Sie können die SoapIncludeAttribute um abgeleitete Klassen in Dokumenten für die Beschreibung aufzunehmen, die in der Web Services Description Language (WSDL) geschrieben werden. Beispielsweise, wenn eine Methode gibt ein Object, gelten die SoapIncludeAttribute an die Methode und geben Sie die tatsächlichen Typen, die zurückgegeben werden sollen.

Weitere Informationen zu WSDL finden Sie in der World Wide Web Consortium (www.w3.org) Spezifikation "Web Services Description Language (WSDL) 1.1".

Weitere Informationen zum Verwenden von Attributen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

Im folgenden Beispiel wird die SoapIncludeAttribute zweimal, um eine XML-Webdienstmethode. Die Methode gibt ein Objekt vom Typ Vehicle (Basisklasse). Die SoapIncludeAttribute Methode zum Zurückgeben von Instanzen von abgeleiteten Klassen ermöglicht die Vehicle Klasse.

.NET Framework
Verfügbar seit 1.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: