SoapIncludeAttribute Osztály

Definíció

Névtér:

System.Xml.Serialization

Szerelvények:

netstandard.dll, System.Xml.XmlSerializer.dll

Forrás:

SoapIncludeAttribute.cs

Lehetővé teszi egy XmlSerializer típus felismerését, amikor szerializál vagy deszerializál egy objektumot kódolt SOAP XML-fájlként.

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

Öröklődés

Object

Attribute

SoapIncludeAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa a SoapIncludeAttribute kétszeri xml webszolgáltatás-metódust alkalmazza. A metódus egy típusobjektumot Vehicle (alaposztályt) ad vissza. Ez SoapIncludeAttribute lehetővé teszi, hogy a metódus visszaadja az osztályból Vehicle származtatott osztályok példányait.

Megjegyzések

Az SoapIncludeAttribute osztály egy attribútumcsaládhoz tartozik, amely azt szabályozza, hogyan XmlSerializer szerializál vagy deszerializál egy objektumot kódolt SOAP XML-fájlként. Az eredményként kapott XML megfelel a World Wide Web Consortium dokumentum, a Simple Object Access Protocol (SOAP) 1.1 című dokumentum 5. szakaszának. A hasonló attribútumok teljes listáját a kódolt SOAP-szerializálást vezérlő attribútumok című témakörben találja.

Ha kódolt SOAP-üzenetként szeretne szerializálni egy objektumot, létre kell hoznia az XmlSerializerXmlTypeMapping osztály metódusával ImportTypeMapping létrehozott objektumot SoapReflectionImporter .

A származtatott SoapIncludeAttributeosztály alkalmazásakor adja meg a Type származtatott osztályt. Ha a szerializálja az XmlSerializer alap- és a származtatott osztályokat is tartalmazó objektumokat, akkor mindkét objektumtípus felismerhető.

A használatával SoapIncludeAttribute származtatott osztályokat vehet fel a webszolgáltatások leírási nyelvén (WSDL) írt szolgáltatásleírási dokumentumokba. Ha például egy metódus egy értéket ad vissza Object, alkalmazza a SoapIncludeAttribute metódust, és adja meg a visszaadandó tényleges típusokat.

További információ a WSDL-ről: World Wide Web Consortium specification, Web Services Description Language (WSDL) 1.1.

Az attribútumok használatáról további információt az Attribútumok című témakörben talál.

Konstruktorok

Name	Description
SoapIncludeAttribute(Type)	Inicializálja az SoapIncludeAttribute osztály új példányát a megadott típussal.

Tulajdonságok

Name	Description
Type	Lekéri vagy beállítja az objektum szerializálása vagy deszerializálása során használni kívánt objektum típusát.
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)