SoapIncludeAttribute Třída

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

netstandard.dll, System.Xml.XmlSerializer.dll

Zdroj:

SoapIncludeAttribute.cs

Umožňuje XmlSerializer rozpoznat typ při serializaci nebo deserializování objektu 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.Interface | 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 metodu vrátit instance tříd odvozených z Vehicle třídy.

Poznámky

Třída SoapIncludeAttribute patří do řady atributů, které řídí, jak XmlSerializer serializuje nebo deserializuje objekt 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é soap serializace.

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

Při použití SoapIncludeAttribute, určete 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 wsDL (Web Services Description Language). Například pokud metoda vrátí Object, použijte na SoapIncludeAttribute metodu a zadejte skutečné typy, které by měly být vráceny.

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

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

Konstruktory

Name	Description
SoapIncludeAttribute(Type)	Inicializuje novou instanci SoapIncludeAttribute třídy pomocí zadaného typu.

Vlastnosti

Name	Description
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

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá Type aktuální instance. (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 pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)