Attributi che controllano la serializzazione con codifica SOAP
Il documento del World Wide Web Consortium (www.w3.org) denominato "Simple Object Access Protocol (SOAP) 1.1" contiene una sezione facoltativa, la 5, in cui viene descritto in che modo i parametri SOAP possono essere codificati (informazioni in lingua inglese). Per essere conformi alla sezione 5 della specifica, è necessario utilizzare una serie speciale di attributi disponibili nello spazio dei nomi System.Xml.Serialization. Applicare questi attributi secondo le esigenze a classi e membri di classi, quindi utilizzare il costruttore XmlSerializer per serializzare le istanze della classe o delle classi.
Nella tabella che segue sono elencati gli attributi, l'ambito di applicazione e la funzione che svolgono. Per ulteriori informazioni sull'utilizzo di questi attributi per controllare la serializzazione XML, vedere Generazione di messaggi SOAP con la serializzazione XML.
Per ulteriori informazioni sugli attributi, vedere Estensione dei metadati mediante attributi.
| Attributo | Si applica a | Specifica |
|---|---|---|
| SoapAttributeAttribute | Campo pubblico, proprietà, parametro o valore restituito. | Il membro di classe verrà serializzato come attributo XML. |
| SoapElementAttribute | Campo pubblico, proprietà, parametro o valore restituito. | La classe verrà serializzata come un elemento XML. |
| SoapEnumAttribute | Campo pubblico che rappresenta un identificatore dell'enumerazione. | Il nome dell'elemento di un membro di enumerazione. |
| SoapIgnoreAttribute | Proprietà e campi pubblici. | La proprietà o il campo deve essere ignorato quando la classe che lo contiene viene serializzata. |
| SoapIncludeAttribute | Dichiarazioni di una classe derivata pubblica e metodi pubblici per documenti WSDL. | Il tipo deve essere incluso durante la generazione degli schemi per essere riconosciuto quando viene serializzato. |
| SoapTypeAttribute | Dichiarazioni delle classi pubbliche. | La classe deve essere serializzata come tipo XML. |
Vedere anche
Serializzazione XML e SOAP | Generazione di messaggi SOAP con la serializzazione XML | Estensione di metadati mediante attributi | XmlSerializer