控制編碼 SOAP 序列化的屬性
全球資訊網協會 (W3C) 的文件《Simple Object Access Protocol (SOAP) 1.1》中有一個選讀章節 (第 5 節),說明 SOAP 參數的編碼方式。 若要遵循第 5 節的規格,您必須使用在 System.Xml.Serialization 命名空間中的特殊屬性集。 套用適合類別與類別成員的那些屬性,然後使用 XmlSerializer 序列化類別的執行個體。
下表顯示屬性、其可套用位置及作用。 如需使用這些屬性來控制 XML 序列化的詳細資訊,請參閱如何:將物件序列化為 SOAP 編碼的 XML 資料流和如何:覆寫編碼的 SOAP XML 序列化。
如需屬性的詳細資訊,請參閱屬性。
屬性 | 適用於 | 指定 |
---|---|---|
SoapAttributeAttribute | 公用欄位、屬性、參數或傳回值。 | 類別成員將會序列化成 XML 屬性。 |
SoapElementAttribute | 公用欄位、屬性、參數或傳回值。 | 類別將會序列化成 XML 項目。 |
SoapEnumAttribute | 為列舉識別項的公用欄位。 | 列舉成員的項目名稱。 |
SoapIgnoreAttribute | 公用屬性與欄位。 | 所屬類別序列化時,略過屬性或欄位。 |
SoapIncludeAttribute | 公用衍生類別宣告以及 Web 服務描述語言 (WSDL) 文件的公用方法。 | 當產生結構描述時應包含型別 (在序列化時辨認)。 |
SoapTypeAttribute | 公用類別宣告 | 類別應序列化成 XML 型別。 |