SoapIncludeAttribute Klasa

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestaw:

System.Xml.XmlSerializer.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

XmlSerializer Umożliwia rozpoznawanie typu podczas serializacji lub deserializacji 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.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 Attribute

Public Class SoapIncludeAttribute
Inherits Attribute

Dziedziczenie

Object

Attribute

SoapIncludeAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

Poniższy przykład stosuje dwa razy metodę SoapIncludeAttribute usługi sieci Web XML. Metoda zwraca obiekt typu Vehicle (klasa bazowa). Metoda SoapIncludeAttribute umożliwia metodzie zwracanie wystąpień klas pochodzących z Vehicle klasy .

Uwagi

Klasa SoapIncludeAttribute należy do rodziny atrybutów, które kontrolują sposób XmlSerializer serializacji lub deserializuje obiekt jako zakodowany 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 PROTOKOŁU SOAP, należy skonstruować XmlSerializer przy użyciu utworzonego XmlTypeMapping ImportTypeMapping przy użyciu metody SoapReflectionImporter klasy .

Podczas stosowania klasy SoapIncludeAttributenależy określić Type klasę pochodną. XmlSerializer Gdy serializuje obiekty, które zawierają zarówno klasę bazową, jak i pochodną, może rozpoznać oba typy obiektów.

Klasy pochodne można uwzględnić SoapIncludeAttribute w dokumentach opisu usług 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ą być zwracane.

Aby uzyskać więcej informacji na temat języka WSDL, zobacz World Wide Web Consortium specification(Specyfikacja konsorcjum 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

SoapIncludeAttribute(Type)

Inicjuje SoapIncludeAttribute nowe wystąpienie klasy przy użyciu określonego typu.

Właściwości

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 Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu 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 Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

_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 dla obiektu, który może służyć do pobierania 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)	Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute)