SoapIncludeAttribute Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ermöglicht dem XmlSerializer die Erkennung eines Typs, wenn ein Objekt serialisiert oder deserialisiert wird, 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.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[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
inherit AttributePublic Class SoapIncludeAttribute
Inherits Attribute- Vererbung
- Attribute
Beispiele
Im folgenden Beispiel wird zweimal SoapIncludeAttribute auf eine XML-Webdienstmethode angewendet. Die Methode gibt ein Objekt vom Typ Vehicle (eine Basisklasse) zurück. Die SoapIncludeAttribute Methode ermöglicht die Rückgabe von Instanzen von Klassen, die von der Vehicle Klasse abgeleitet wurden.
Hinweise
Die SoapIncludeAttribute Klasse gehört zu einer Familie von Attributen, die steuern, wie die XmlSerializer Serialisierung oder Deserialisierung eines Objekts als codierte SOAP-XML gesteuert wird. Die resultierende XML entspricht Abschnitt 5 des World Wide Web Consortium-Dokuments, Simple Object Access Protocol (SOAP) 1.1. Eine vollständige Liste mit ähnlichen Attributen finden Sie unter Attribute That Control Encoded SOAP Serialization.
Um ein Objekt als codierte SOAP-Nachricht zu serialisieren, müssen Sie die XmlSerializer Verwendung einer XmlTypeMapping mit der ImportTypeMapping Methode der SoapReflectionImporter Klasse erstellten Erstellen erstellen.
Geben Sie beim Anwenden der SoapIncludeAttributeabgeleiteten Klasse die Type abgeleitete Klasse an. Wenn die XmlSerializer Objekte serialisiert, die sowohl die Basis als auch die abgeleiteten Klassen enthalten, können beide Objekttypen erkannt werden.
Sie können abgeleitete SoapIncludeAttribute Klassen in Dienstbeschreibungsdokumente einschließen, die in der Beschreibungssprache für Webdienste (Web Services Description Language, WSDL) geschrieben sind. Wenn eine Methode z. B. eine ObjectMethode zurückgibt, wenden Sie die SoapIncludeAttribute 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
| Name | Beschreibung |
|---|---|
| SoapIncludeAttribute(Type) |
Initialisiert eine neue Instanz der SoapIncludeAttribute Klasse mithilfe des angegebenen Typs. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Type |
Dient zum Abrufen oder Festlegen des Typs des Objekts, das beim Serialisieren oder Deserialisieren eines Objekts verwendet werden soll. |
| TypeId |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute) |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| GetHashCode() |
Gibt den Hashcode für diesen instance zurück. (Geerbt von Attribute) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsDefaultAttribute() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute) |
| Match(Object) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute) |
