SoapIncludeAttribute Classe

Definizione

Spazio dei nomi:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Source:

SoapIncludeAttribute.cs

Consente il riconoscimento di un tipo da parte della classe XmlSerializer quando un oggetto viene serializzato o deserializzato nel formato XML SOAP codificato.

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

Ereditarietà

Object

Attribute

SoapIncludeAttribute

Attributi

AttributeUsageAttribute

Esempio

L'esempio seguente applica due SoapIncludeAttribute volte a un metodo di servizio Web XML. Il metodo restituisce un oggetto di tipo Vehicle (una classe base). Consente SoapIncludeAttribute al metodo di restituire istanze di classi derivate dalla Vehicle classe.

Commenti

La SoapIncludeAttribute classe appartiene a una famiglia di attributi che controlla la modalità XmlSerializer di serializzazione o deserializza, un oggetto come XML SOAP codificato. Il codice XML risultante è conforme alla sezione 5 del documento World Wide Web Consortium, Simple Object Access Protocol (SOAP) 1.1. Per un elenco completo di attributi simili, vedere Attributi che controllano la serializzazione SOAP codificata.

Per serializzare un oggetto come messaggio SOAP codificato, è necessario costruire l'uso XmlSerializer di un XmlTypeMapping oggetto creato con il ImportTypeMapping metodo della SoapReflectionImporter classe.

Quando si applica , specificare l'oggetto SoapIncludeAttributeType della classe derivata. Quando serializza XmlSerializer oggetti che includono sia la base che le classi derivate, può quindi riconoscere entrambi i tipi di oggetto.

È possibile usare per SoapIncludeAttribute includere classi derivate nei documenti di descrizione del servizio scritti nel linguaggio WSDL (Web Services Description Language). Ad esempio, se un metodo restituisce un Objectoggetto , applicare l'oggetto SoapIncludeAttribute al metodo e specificare i tipi effettivi che devono essere restituiti.

Per altre informazioni su WSDL, vedere Specifica World Wide Web Consortium, Web Services Description Language (WSDL) 1.1.

Per altre informazioni sull'uso degli attributi, vedere Attributi.

Costruttori

SoapIncludeAttribute(Type)

Inizializza una nuova istanza della classe SoapIncludeAttribute utilizzando il tipo specificato.

Proprietà

Type	Ottiene o imposta il tipo dell'oggetto da utilizzare durante la serializzazione o deserializzazione di un oggetto.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)