SoapIncludeAttribute Klasa

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestaw:

System.Xml.dll

Umożliwia XmlSerializer rozpoznawanie typu podczas serializacji lub deserializowania obiektu jako zakodowanego kodu XML PROTOKOŁU SOAP.

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

Dziedziczenie

Object

Attribute

SoapIncludeAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

Poniższy przykład stosuje dwa razy do SoapIncludeAttribute metody usługi sieci Web XML. Metoda zwraca obiekt typu Vehicle (klasa podstawowa). Metoda SoapIncludeAttribute umożliwia metodzie zwracanie wystąpień klas pochodnych z Vehicle klasy.

Uwagi

Klasa SoapIncludeAttribute należy do rodziny atrybutów, które steruje sposobem XmlSerializer serializacji lub deserializuje obiekt jako kodowany KOD XML PROTOKOŁU SOAP. Wynikowy kod XML jest zgodny z sekcją 5 dokumentu World Wide Web Consortium, Simple Object Access Protocol (SOAP) 1.1. Aby uzyskać pełną listę podobnych atrybutów, zobacz Atrybuty, które kontrolują zakodowaną serializacji protokołu SOAP.

Aby serializować obiekt jako zakodowany komunikat SOAP, należy skonstruować XmlSerializer przy użyciu utworzonego XmlTypeMappingImportTypeMapping przy użyciu metody SoapReflectionImporter klasy .

Podczas stosowania SoapIncludeAttributeklasy , określ Type klasę pochodną. XmlSerializer Gdy serializuje obiekty, które obejmują zarówno bazę, jak i klasy pochodne, może rozpoznać oba typy obiektów.

Można użyć elementu SoapIncludeAttribute , aby uwzględnić klasy pochodne w dokumentach opisu usługi napisanych w języku WSDL (Web Services Description Language). Jeśli na przykład metoda zwraca metodę , zastosuj SoapIncludeAttribute metodę Objectdo metody i określ rzeczywiste typy, które mają zostać zwrócone.

Aby uzyskać więcej informacji na temat języka WSDL, zobacz Specyfikacje World Wide Web Consortium, Web Services Description Language (WSDL) 1.1.

Aby uzyskać więcej informacji na temat używania atrybutów, zobacz Atrybuty.

Konstruktory

Nazwa	Opis
SoapIncludeAttribute(Type)	Inicjuje nowe wystąpienie SoapIncludeAttribute klasy przy użyciu określonego typu.

Właściwości

Nazwa	Opis
Type	Pobiera lub ustawia typ obiektu do użycia podczas serializacji lub deserializacji obiektu.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attribute. (Odziedziczone po Attribute)

Metody

Nazwa	Opis
Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca kod skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Po zastąpieniu w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po zastąpieniu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

Nazwa	Opis
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie obiektu, którego można użyć do uzyskania informacji o typie dla interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Zapewnia dostęp do właściwości i metod uwidocznionych przez obiekt. (Odziedziczone po Attribute)