SoapIncludeAttribute Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.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 AttributePublic Class SoapIncludeAttribute
Inherits Attribute- Ereditarietà
- Attributi
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) |
Implementazioni dell'interfaccia esplicita
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da Attribute) |
| _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. (Ereditato da Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute) |
