控制編碼 SOAP 序列化的屬性
標題為<Simple Object Access Protocol (SOAP) 1.1>的全球資訊網協會 (www.w3.org) 文件包含一選擇性章節 (第五節),其中描述如何編碼 SOAP 參數。若要與規格的第五節相符,您必須使用可在 System.Xml.Serialization 命名空間中找到的一組特殊屬性。視需要將這些屬性套用至類別和類別的成員,接著使用 XmlSerializer 來序列化類別的執行個體。
下表將列出屬性、可將它們套用至哪些項目及其用途。如需使用這些屬性來控制 XML 序列化的詳細資訊,請參閱使用 XML 序列化產生 SOAP 訊息。
如需屬性的詳細資訊,請參閱使用屬性 (Attribute) 擴充中繼資料。
屬性 | 適用於 | 指定 |
---|---|---|
SoapAttributeAttribute | 公用欄位、屬性、參數或傳回值。 | 將類別成員序列化為 XML 屬性。 |
SoapElementAttribute | 公用欄位、屬性、參數或傳回值。 | 將類別序列化為 XML 項目。 |
SoapEnumAttribute | 本身為列舉識別項的公用欄位。 | 列舉成員的項目名稱。 |
SoapIgnoreAttribute | 公用屬性和欄位。 | 當序列化包含類別時,應忽略屬性或欄位。 |
SoapIncludeAttribute | 公用衍生類別宣告和供 Web 服務描述語言 (WSDL) 文件使用的公用方法。 | 當產生結構描述時,應包含型別 (以便在序列化時辨識出來)。 |
SoapTypeAttribute | 公用類別宣告。 | 應將類別序列化為 XML 型別。 |
請參閱
XML 和 SOAP 序列化 | 使用 XML 序列化產生 SOAP 訊息 | 使用屬性 (Attribute) 擴充中繼資料 | XmlSerializer