SoapIncludeAttribute Třída

Reference

Definice

Obor názvů:: System.Xml.Serialization

Sestavení:: System.Xml.XmlSerializer.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

XmlSerializer Umožňuje rozpoznat typ, když serializuje nebo deserializuje objekt jako kódovaný KÓD 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 Attribute

Public Class SoapIncludeAttribute
Inherits Attribute

Dědičnost: Object

Attribute
SoapIncludeAttribute

Atributy: AttributeUsageAttribute

Příklady

Následující příklad dvakrát použije SoapIncludeAttribute metodu webové služby XML. Metoda vrátí objekt typu Vehicle (základní třída). Umožňuje SoapIncludeAttribute metodě vrátit instance tříd odvozené z Vehicle třídy.

Poznámky

Třída SoapIncludeAttribute patří do řady atributů, které řídí XmlSerializer způsob serializace nebo deserializes objektu jako kódovaný SOAP XML. Výsledný kód XML odpovídá části 5 dokumentu konsorcia World Wide Web Consortium , protokolu SOAP (Simple Object Access Protocol) 1.1. Úplný seznam podobných atributů naleznete v části Atributy, které řídí kódované serializace SOAP.

Chcete-li serializovat objekt jako kódovanou zprávu SOAP, je nutné vytvořit XmlSerializer pomocí XmlTypeMapping vytvořené pomocí ImportTypeMapping metody SoapReflectionImporter třídy.

Při použití SoapIncludeAttribute, zadejte Type odvozenou třídu. XmlSerializer Když serializuje objekty, které zahrnují jak základní, tak odvozené třídy, pak může rozpoznat oba typy objektů.

Můžete použít SoapIncludeAttribute k zahrnutí odvozených tříd do dokumentů popisu služby, které jsou napsané v jazyce WSDL (Web Services Description Language). Pokud například metoda vrátí hodnotu Object, použijte na SoapIncludeAttribute metodu a zadejte skutečné typy, které mají být vráceny.

Další informace o WSDL naleznete v tématu Specifikace konsorcia World Wide Web Consortium, Web Services Description Language (WSDL) 1.1.

Další informace o používání atributů naleznete v tématu Atributy.

Konstruktory

SoapIncludeAttribute(Type)

Inicializuje novou instanci SoapIncludeAttribute třídy pomocí zadaného typu.

Vlastnosti

Type	Získá nebo nastaví typ objektu, který se má použít při serializaci nebo deserializaci objektu.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou odvozené třídy. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání. (Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Načte informace o typu objektu, který lze použít k získání informací o typu rozhraní. (Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1). (Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Poskytuje přístup k vlastnostem a metodám vystaveným objektem. (Zděděno od Attribute)

Platí pro