SoapIncludeAttribute SoapIncludeAttribute SoapIncludeAttribute SoapIncludeAttribute Class

Definizione

Consente il riconoscimento di un tipo da parte della classe XmlSerializer quando un oggetto viene serializzato o deserializzato nel formato XML SOAP codificato.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object as encoded SOAP XML.

public ref class SoapIncludeAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct | System.AttributeTargets.Method, AllowMultiple=true)]
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct | System.AttributeTargets.Method | System.AttributeTargets.Interface, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute
type SoapIncludeAttribute = class
    inherit Attribute
Public Class SoapIncludeAttribute
Inherits Attribute
Ereditarietà
SoapIncludeAttributeSoapIncludeAttributeSoapIncludeAttributeSoapIncludeAttribute
Attributi

Esempi

L'esempio seguente applica il SoapIncludeAttribute due volte per un metodo di servizio Web XML.The following example applies the SoapIncludeAttribute twice to an XML Web service method. Il metodo restituisce un oggetto di tipo Vehicle (una classe di base).The method returns an object of type Vehicle (a base class). Il SoapIncludeAttribute consente al metodo restituire istanze di classi derivate dal Vehicle classe.The SoapIncludeAttribute allows the method to return instances of classes derived from the Vehicle class.

Commenti

Il SoapIncludeAttribute classe appartiene a una famiglia di attributi che controlla come il XmlSerializer serializza o deserializza un oggetto nel formato XML SOAP codificato.The SoapIncludeAttribute class belongs to a family of attributes that controls how the XmlSerializer serializes, or deserializes, an object as encoded SOAP XML. Il codice XML risultante è conforme alla sezione 5 del documento, World Wide Web Consortium SOAP Simple Object Access Protocol () 1.1.The resulting XML conforms to section 5 of the World Wide Web Consortium document, Simple Object Access Protocol (SOAP) 1.1. Per un elenco completo degli attributi simili, vedere attributi che controllo serializzazione SOAP codificata.For a complete list of similar attributes, see Attributes That Control Encoded SOAP Serialization.

Per serializzare un oggetto come un messaggio con codificato SOAP, è necessario costruire il XmlSerializer usando un' XmlTypeMapping creati con la ImportTypeMapping metodo del SoapReflectionImporter classe.To serialize an object as an encoded SOAP message, you must construct the XmlSerializer using an XmlTypeMapping created with the ImportTypeMapping method of the SoapReflectionImporter class.

Quando si applica il SoapIncludeAttribute, specificare il Type della classe derivata.When applying the SoapIncludeAttribute, specify the Type of the derived class. Quando il XmlSerializer serializza gli oggetti che includono sia la base e le classi derivate, è possibile riconoscere entrambi i tipi di oggetto.When the XmlSerializer serializes objects that include both the base and the derived classes, it can then recognize both object types.

È possibile usare il SoapIncludeAttribute per includere le classi derivate in documenti di descrizione del servizio che vengono scritti nei servizi descrizione linguaggio WSDL (Web).You can use the SoapIncludeAttribute to include derived classes in service description documents that are written in the Web Services Description Language (WSDL). Ad esempio, se un metodo restituisce un Object, applicare il SoapIncludeAttribute al metodo e specificare i tipi effettivi che devono essere restituiti.For example, if a method returns an Object, apply the SoapIncludeAttribute to the method and specify the actual types that should be returned.

Per altre informazioni su WSDL, vedere Specifica World Wide Web Consortium Web Services Description Language (WSDL) 1.1.For more information about WSDL, see World Wide Web Consortium specification, Web Services Description Language (WSDL) 1.1.

Per altre informazioni sull'utilizzo di attributi, vedere attributi.For more information about using attributes, see Attributes.

Costruttori

SoapIncludeAttribute(Type) SoapIncludeAttribute(Type) SoapIncludeAttribute(Type) SoapIncludeAttribute(Type)

Inizializza una nuova istanza della classe SoapIncludeAttribute utilizzando il tipo specificato.Initializes a new instance of the SoapIncludeAttribute class using the specified type.

Proprietà

Type Type Type Type

Ottiene o imposta il tipo dell'oggetto da utilizzare durante la serializzazione o deserializzazione di un oggetto.Gets or sets the type of the object to use when serializing or deserializing an object.

TypeId TypeId TypeId TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Si applica a