System.Xml.Serialization 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
包含用於將物件序列化為 XML 格式文件或串流的類別。
類別
| 名稱 | Description |
|---|---|
| CodeExporter |
代表一個能從資料結構的 XML 表示產生代理碼的類別。 |
| CodeIdentifier |
提供靜態方法將輸入文字轉換為程式碼實體名稱。 |
| CodeIdentifiers |
維護一組相關程式碼實體或類型映射的名稱,這些映射由 。NET 的 XML 序列化基礎設施。 |
| ImportContext |
描述一組結構綁定到 .NET 程式碼實體的情境。 |
| SchemaImporter |
描述一個結構導入器。 |
| SoapAttributeAttribute |
指定 XmlSerializer 必須將類別成員串行化為編碼的SOAP屬性。 |
| SoapAttributeOverrides |
當你用 以 XmlSerializer 編碼 SOAP 來序列化或反序列化物件時,可以覆寫屬性、欄位和類別的屬性。 |
| SoapAttributes |
代表一組屬性物件,用以控制 SOAP 方法的 XmlSerializer 序列化與反序列化。 |
| SoapCodeExporter |
根據 WSDL 文件中定義的 SOAP 編碼訊息部分的內部型別映射資訊,產生型別與屬性宣告。 |
| SoapElementAttribute |
指定 XmlSerializer 串行化為編碼的 SOAP XML 元素的公用成員值。 |
| SoapEnumAttribute |
控制 XmlSerializer 串行化列舉成員的方式。 |
| SoapIgnoreAttribute |
指示 XmlSerializer 不要串行化公用欄位或公用讀取/寫入屬性值。 |
| SoapIncludeAttribute |
當 XmlSerializer 串行化或還原串行化對象為編碼的 SOAP XML 時,可讓 XmlSerializer 辨識類型。 |
| SoapReflectionImporter |
從 .NET 類型或 Web 服務方法資訊產生 SOAP 編碼訊息的映射。 |
| SoapSchemaExporter |
為 XmlSchema 使用 SOAP 編碼序列化的 .NET 類型,填充物件的 XML Schema 資料型別定義。 |
| SoapSchemaImporter |
用於 .NET Framework 中,為 WSDL 文件中 SOAP 編碼的訊息部分產生內部 .NET 類型的映射。 |
| SoapSchemaMember |
代表 WSDL 文件中 XSD < |
| SoapTypeAttribute |
控制當類別實例串行化為SOAP編碼 XML時,XmlSerializer 所產生的架構。 |
| UnreferencedObjectEventArgs |
提供在反序列化過程中,編碼 SOAP XML 串流中已知但未被引用的物件資料。 |
| XmlAnyAttributeAttribute |
指定成員(傳回 XmlAttribute 物件陣列的欄位)可以包含任何 XML 屬性。 |
| XmlAnyElementAttribute |
指定成員(傳回 XmlElement 或 XmlNode 對象陣列的欄位)包含物件,這些物件表示串行化或還原串行化之物件中沒有任何對應成員的任何 XML 專案。 |
| XmlAnyElementAttributes |
代表一組 XmlAnyElementAttribute 物件。 |
| XmlArrayAttribute |
指定 XmlSerializer 必須將特定類別成員串行化為 XML 項目的陣列。 |
| XmlArrayItemAttribute |
表示屬性,指定 XmlSerializer 可以放在串行化陣列中的衍生型別。 |
| XmlArrayItemAttributes |
代表一組 XmlArrayItemAttribute 物件。 |
| XmlAttributeAttribute |
指定 XmlSerializer 必須將類別成員串行化為 XML 屬性。 |
| XmlAttributeEventArgs |
提供 UnknownAttribute 事件的資料。 |
| XmlAttributeOverrides |
允許你在使用 S XmlSerializer 來序列化或反序列化物件時,覆蓋屬性、欄位和類別屬性。 |
| XmlAttributes |
代表一組屬性物件,用以控制物件序列 XmlSerializer 化與反序列化的方式。 |
| XmlChoiceIdentifierAttribute |
指定可以使用 列舉進一步偵測成員。 |
| XmlCodeExporter |
從內部型別映射資訊產生 XML schema 元素宣告的類型與屬性宣告。 |
| XmlElementAttribute |
表示當 XmlSerializer 串行化或還原串行化包含它的 物件時,公用欄位或屬性代表 XML 元素。 |
| XmlElementAttributes |
代表一組 XmlElementAttribute 物件,用於 XmlSerializer 覆蓋預設序列化類別的方式。 |
| XmlElementEventArgs |
提供 UnknownElement 事件的資料。 |
| XmlEnumAttribute |
控制 XmlSerializer 串行化列舉成員的方式。 |
| XmlIgnoreAttribute |
指示 Serialize(TextWriter, Object)XmlSerializer 方法不要串行化公用欄位或公用讀取/寫入屬性值。 |
| XmlIncludeAttribute |
允許 XmlSerializer 在串行化或還原串行化物件時辨識類型。 |
| XmlMapping |
支援 .NET 類型與 XML Schema 資料型態之間的映射。 |
| XmlMemberMapping |
將 .NET Web 服務方法中的程式碼實體映射到網路服務描述語言(WSDL)訊息中的元素。 |
| XmlMembersMapping |
提供 .NET Web 服務方法與為 SOAP Web 服務定義的 Web Services Description Language(WSDL)訊息之間的對應。 |
| XmlNamespaceDeclarationsAttribute |
指定目標屬性、參數、傳回值或類別成員包含與 XML 檔內所使用的命名空間相關聯的前置詞。 |
| XmlNodeEventArgs |
提供 UnknownNode 事件的資料。 |
| XmlReflectionImporter |
產生映射到 XML 結構元素宣告,包括 Web 服務描述語言(WSDL)文件中的 XML 結構定義(XSD)訊息部分,用於 .NET 類型或 Web 服務方法資訊。 |
| XmlReflectionMember |
提供 .NET Web 服務方法中的程式碼實體與為 SOAP Web 服務定義的 Web Services Description Language(WSDL)訊息內容之間的對應。 |
| XmlRootAttribute |
將屬性目標的 XML 串行化控制為 XML 根元素。 |
| XmlSchemaEnumerator |
允許對一組 XmlSchema 物件進行迭代。 |
| XmlSchemaExporter |
在物件中填充 XmlSchema XML 結構元素宣告,這些宣述存在於型別映射物件中。 |
| XmlSchemaImporter |
產生內部映射到 .NET 類型,用於 XML 結構元素宣告,包括 WSDL 文件中的 XSD 訊息部分。 |
| XmlSchemaProviderAttribute |
套用至類型時,會儲存傳回 XML 架構之型別的靜態方法名稱,以及控制型別串行化之匿名型別的 XmlQualifiedName(或 XmlSchemaType)。 |
| XmlSchemas |
代表 XML 結構的集合。 |
| XmlSerializationGeneratedCode |
一個抽象類別,是 和 XmlSerializationWriter 的XmlSerializationReader基底類別,包含這兩種類型的共通方法。 |
| XmlSerializationReader |
控制類別的 XmlSerializer 反序列化。 |
| XmlSerializationReader.CollectionFixup |
儲存 XmlSerializationCollectionFixupCallback 代理實例及方法的輸入;同時提供方法的參數。 |
| XmlSerializationReader.Fixup |
儲存 XmlSerializationFixupCallback 一個代理實例,以及方法的輸入;同時也是方法的參數。 |
| XmlSerializationWriter |
代表一個抽象類別,用於控制類別的 XmlSerializer 序列化。 |
| XmlSerializer |
將物件序列化與反序列化,進出 XML 文件。 這 XmlSerializer 讓你能控制物件如何編碼成 XML。 |
| XmlSerializerAssemblyAttribute |
套用至 Web 服務用戶端 Proxy,可讓您指定包含自定義串行化程式的元件。 |
| XmlSerializerFactory |
建立 的 XmlSerializer 類型版本以提升序列化效率。 |
| XmlSerializerImplementation |
定義了預生成、打字序列器的讀取器、寫者及方法。 |
| XmlSerializerNamespaces |
包含用於在 XML 文件實例中產生合格名稱的 XML 命名空間與前綴 XmlSerializer 。 |
| XmlSerializerVersionAttribute |
表示程式代碼是由串行化基礎結構所產生,而且當此屬性套用至元件時,可以重複使用以提升效能。 |
| XmlTextAttribute |
表示當包含成員的類別串行化或還原串行化時,XmlSerializer 成員必須視為 XML 文字。 |
| XmlTypeAttribute |
控制當屬性目標由 XmlSerializer串行化時所產生的 XML 架構。 |
| XmlTypeMapping |
包含一種類型到另一種類型的映射。 |
結構
| 名稱 | Description |
|---|---|
| XmlDeserializationEvents |
包含字段,可用來將事件委派傳遞至 Deserialize之安全線程 XmlSerializer 方法。 |
介面
| 名稱 | Description |
|---|---|
| IXmlSerializable |
提供XML序列化與反序列化的自訂格式。 |
| IXmlTextParser |
建立 Normalized 一個屬性供 .NET 基礎架構使用。 |
列舉
| 名稱 | Description |
|---|---|
| CodeGenerationOptions |
指定產生 .NET 類型以搭配 XML Web 服務使用時要使用的各種選項。 |
| XmlMappingAccess |
指定對應是否為讀取、寫入或兩者。 |
委派
| 名稱 | Description |
|---|---|
| UnreferencedObjectEventHandler |
代表處理 UnreferencedObject 事件 XmlSerializer的方法。 |
| XmlAttributeEventHandler |
代表處理 的方法 UnknownAttribute。 |
| XmlElementEventHandler |
代表處理 UnknownElement 事件 XmlSerializer的方法。 |
| XmlNodeEventHandler |
代表處理 UnknownNode 事件 XmlSerializer的方法。 |
| XmlSerializationCollectionFixupCallback |
類別用於 XmlSerializer 反序列化 SOAP 編碼的 XML 資料型別,這些資料對應到集合或列舉。 |
| XmlSerializationFixupCallback |
類別用於 XmlSerializer SOAP 編碼 XML 資料的反序列化代理。 |
| XmlSerializationReadCallback |
類別用於 XmlSerializer 從 SOAP 編碼的非根 XML 資料中反序列化型別的代理。 |
| XmlSerializationWriteCallback |
代理 該類別用於 XmlSerializer 從 SOAP 編碼的非根 XML 資料序列化型別。 |
備註
命名空間中的核心類別是類別 XmlSerializer 。 要使用此類別,請使用 XmlSerializer 建構子,利用該物件的類型來建立該類別的實例。 建立 後 XmlSerializer ,建立該物件的實例進行序列化。 你還必須建立一個物件來將檔案寫入文件或串流,例如 Stream、 TextWriter、 XmlWriter或 。 接著你可以呼叫 Serialize 該方法,將物件轉換成 XML 文件。
要將物件從 XML 文件反序列化,請建立一個合適的物件來讀取文件或串流(同樣是 Stream、 TextWriter、 XmlWriter或 )。 在將所得物件投射為原始物件類型(序列化後)時,呼叫該 Deserialize 方法。
為了進一步控制序列化,命名 System.Xml.Serialization 空間包含多個 Attribute 類別,可以套用到類別的成員。 例如,如果一個類別包含一個成員,該成員將被序列化為 XML 元素,你可以將該 XmlElementAttribute 屬性套用到該成員身上。 套用屬性時,你可以用屬性 ElementName 指定細節,例如實際的 XML 元素名稱。 所有屬性的完整清單,請參閱 XmlSerializer 職業概述。