控制 XML 序列化的屬性
您可以將下表中的屬性套用到類別和類別成員,以便控制 XmlSerializer 序列化或還原序列化類別之執行個體的方式。 若要了解這些屬性如何控制 XML 序列化,請參閱使用屬性控制 XML 序列化。
這些屬性也可用來控制 XML Web Service 產生的常值樣式 SOAP 訊息。 如需將這些屬性套用至 XML Web Service 方法的詳細資訊,請參閱以 XML Web Service 進行 XML 序列化。
如需屬性的詳細資訊,請參閱屬性。
屬性 | 適用於 | 指定 |
---|---|---|
XmlAnyAttributeAttribute | 公用欄位、屬性、參數或傳回 XmlAttribute 物件陣列的傳回值。 | 當還原序列化時,陣列將填入代表所有結構描述未知之 XML 屬性的 XmlAttribute 物件。 |
XmlAnyElementAttribute | 公用欄位、屬性、參數或傳回 XmlElement 物件陣列的傳回值。 | 當還原序列化時,陣列將填入代表所有結構描述未知之 XML 項目的 XmlElement 物件。 |
XmlArrayAttribute | 公用欄位、屬性、參數或傳回複雜物件陣列的傳回值。 | 陣列的成員將產生為 XML 陣列的成員。 |
XmlArrayItemAttribute | 公用欄位、屬性、參數或傳回複雜物件陣列的傳回值。 | 可插入陣列的衍生型別。 通常與 XmlArrayAttribute 一起套用。 |
XmlAttributeAttribute | 公用欄位、屬性、參數或傳回值。 | 成員將會序列化成 XML 屬性。 |
XmlChoiceIdentifierAttribute | 公用欄位、屬性、參數或傳回值。 | 使用列舉型別可進一步明確識別成員。 |
XmlElementAttribute | 公用欄位、屬性、參數或傳回值。 | 欄位或屬性將序列化成 XML 項目。 |
XmlEnumAttribute | 為列舉識別項的公用欄位。 | 列舉成員的項目名稱。 |
XmlIgnoreAttribute | 公用屬性與欄位。 | 所屬類別序列化時,略過屬性或欄位。 |
XmlIncludeAttribute | 公用衍生類別宣告以及 Web 服務描述語言 (WSDL) 文件的公用方法傳回值。 | 當產生結構描述時應包含類別 (在序列化時辨認)。 |
XmlRootAttribute | 公用類別宣告 | 控制做為 XML 根項目之屬性目標的 XML 序列化。 請使用屬性更進一步指定命名空間與項目名稱。 |
XmlTextAttribute | 公用屬性與欄位。 | 屬性或欄位應序列化成 XML 文字。 |
XmlTypeAttribute | 公用類別宣告 | XML 型別的名稱與命名空間。 |
ObsoleteAttribute | 公用屬性與欄位。 | 當包含的類別串行化時,將會忽略屬性或欄位。 |
除了這些在 System.Xml.Serialization 命名空間都找得到的屬性之外,您也可以對欄位套用 DefaultValueAttribute 屬性。 如果未指定任何值,DefaultValueAttribute 會設定將自動指派給成員的值。
若要控制編碼的 SOAP XML 序列化,請參閱控制編碼 SOAP 序列化的屬性。