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 al XmlSerializer di riconoscere un tipo quando serializza o deserializza un oggetto come XML SOAP codificato.
public ref 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)]
public class SoapIncludeAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
inherit Attribute[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
inherit AttributePublic Class SoapIncludeAttribute
Inherits Attribute- Ereditarietà
- Attributi
Esempio
Nell'esempio seguente viene applicato due SoapIncludeAttribute volte a un metodo di servizio Web XML. Il metodo restituisce un oggetto di tipo Vehicle (una classe base).
SoapIncludeAttribute consente al metodo di restituire istanze di classi derivate dalla Vehicle classe .
Commenti
La SoapIncludeAttribute classe appartiene a una famiglia di attributi che controlla la XmlSerializer modalità 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 XmlSerializer utilizzando un XmlTypeMapping oggetto creato con il ImportTypeMapping metodo della SoapReflectionImporter classe .
Quando si applica , SoapIncludeAttributespecificare l'oggetto Type della classe derivata. Quando l'oggetto XmlSerializer serializza oggetti che includono sia la base che le classi derivate, può quindi riconoscere entrambi i tipi di oggetto.
È possibile utilizzare SoapIncludeAttribute per 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 SoapIncludeAttribute al metodo e specificare i tipi effettivi che devono essere restituiti.
Per altre informazioni su WSDL, vedere Specifiche del World Wide Web Consortium, WSDL (Web Services Description Language) 1.1.
Per altre informazioni sull'uso degli attributi, vedere Attributi.
Costruttori
| Nome | Descrizione |
|---|---|
| SoapIncludeAttribute(Type) |
Inizializza una nuova istanza della SoapIncludeAttribute classe utilizzando il tipo specificato. |
Proprietà
| Nome | Descrizione |
|---|---|
| Type |
Ottiene o imposta il tipo dell'oggetto da utilizzare durante la serializzazione o la deserializzazione di un oggetto. |
| TypeId |
Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute. (Ereditato da Attribute) |
Metodi
| Nome | Descrizione |
|---|---|
| Equals(Object) |
Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute) |
| GetHashCode() |
Restituisce il codice hash per questa istanza. (Ereditato da Attribute) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| IsDefaultAttribute() |
Quando sottoposto a 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 è uguale a un oggetto specificato. (Ereditato da Attribute) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Esegue il mapping di un set di nomi a un set corrispondente di identificatori dispatch. (Ereditato da Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Recupera le informazioni sul tipo per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per un'interfaccia. (Ereditato da Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Recupera il numero di 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 alle proprietà e ai metodi esposti da un oggetto . (Ereditato da Attribute) |