System.Xml.Serialization 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
包含類別,用來將物件序列化為 XML 格式的文件或資料流。
類別
CodeExporter |
表示可從資料結構之 XML 表示產生 Proxy 程式碼的類別。 |
CodeIdentifier |
提供可將輸入文字轉換成程式碼實體 (Entity) 之名稱的靜態方法。 |
CodeIdentifiers |
針對由 .NET 之 XML 序列化基礎結構所產生的相關程式碼實體或型別對應,維護名稱群組。 |
ImportContext |
描述結構描述集合要繫結至 .NET 程式碼實體的內容。 |
SchemaImporter |
描述結構描述匯入工具。 |
SoapAttributeAttribute |
指定 XmlSerializer 必須將類別成員序列化為編碼的 SOAP 屬性。 |
SoapAttributeOverrides |
使用 XmlSerializer 將物件序列化或還原序列化為編碼的 SOAP 時,可讓您覆寫套用至屬性 (Property)、欄位和類別的屬性 (Attribute)。 |
SoapAttributes |
表示用來控制 XmlSerializer 序列化與還原序列化 SOAP 方法的屬性 (Attribute) 物件集合。 |
SoapCodeExporter |
從 WSDL 文件中定義之 SOAP 編碼訊息部分的內部型別對應資訊,產生型別和屬性 (Attribute) 宣告。 |
SoapElementAttribute |
指定公用成員值由 XmlSerializer 序列化為編碼 SOAP XML 項目。 |
SoapEnumAttribute |
控制 XmlSerializer 序列化列舉型別 (Enumeration) 成員的方式。 |
SoapIgnoreAttribute |
表示 XmlSerializer 不要將公用欄位或公用讀取/寫入屬性值序列化。 |
SoapIncludeAttribute |
允許 XmlSerializer 在將物件序列化或還原序列化為編碼 SOAP XML 時,辨認型別。 |
SoapReflectionImporter |
從 .NET 型別或 Web 服務方法資訊產生 SOAP 編碼訊息的對應。 |
SoapSchemaExporter |
使用以 SOAP 編碼序列化之 .NET Framework 型別的 XML 結構描述資料型別定義,填入 (Populate) XmlSchema 物件。 |
SoapSchemaImporter |
在 .NET Framework 中使用,以便針對 WSDL 文件中的 SOAP 編碼訊息部分產生 .NET Framework 型別的內部對應。 |
SoapSchemaMember |
在 WSDL 文件中代表 XSD < |
SoapTypeAttribute |
控制類別執行個體被序列化為 SOAP 編碼 XML 時,XmlSerializer 所產生的結構描述。 |
UnreferencedObjectEventArgs |
提供在還原序列化 (Deserialization) 時,於編碼 SOAP XML 資料流中發現之已知,但是未被參考到的物件。 |
XmlAnyAttributeAttribute |
指定成員 (傳回 XmlAttribute 物件陣列的欄位) 可以包含任何 XML 屬性。 |
XmlAnyElementAttribute |
指定成員 (傳回 XmlElement 或 XmlNode 物件陣列的欄位) 包含物件,該物件表示在序列化或還原序列化物件中沒有對應成員的任何 XML 項目。 |
XmlAnyElementAttributes |
表示 XmlAnyElementAttribute 物件的集合。 |
XmlArrayAttribute |
指定 XmlSerializer 必須將特定類別成員序列化為 XML 項目的陣列。 |
XmlArrayItemAttribute |
表示屬性,這個屬性會指定 XmlSerializer 可置於序列化陣列中的衍生型別。 |
XmlArrayItemAttributes |
表示 XmlArrayItemAttribute 物件的集合。 |
XmlAttributeAttribute |
指定 XmlSerializer 必須將類別成員序列化為 XML 屬性。 |
XmlAttributeEventArgs |
提供 UnknownAttribute 事件的資料。 |
XmlAttributeOverrides |
當使用 XmlSerializer 來序列化或還原序列化物件時,允許您覆寫屬性 (Property)、欄位和類別屬性 (Attribute)。 |
XmlAttributes |
表示用來控制 XmlSerializer 序列化與還原序列化物件方式的屬性 (Attribute) 物件集合。 |
XmlChoiceIdentifierAttribute |
指定可以使用列舉進一步偵測成員。 |
XmlCodeExporter |
從 XML 結構描述項目宣告的內部型別對應資訊,產生型別和屬性 (Attribute) 宣告。 |
XmlElementAttribute |
表示在 XmlSerializer 序列化或還原序列化包含 XML 項目的物件時,公用欄位或屬性表示該項目。 |
XmlElementAttributes |
代表 XmlElementAttribute 物件的集合,XmlSerializer 使用這些物件來覆寫其序列化類別的預設方式。 |
XmlElementEventArgs |
提供 UnknownElement 事件的資料。 |
XmlEnumAttribute |
控制 XmlSerializer 序列化列舉型別 (Enumeration) 成員的方式。 |
XmlIgnoreAttribute |
表示 Serialize(TextWriter, Object) 的 XmlSerializer 方法不要序列化公用欄位或公用讀取/寫入屬性值。 |
XmlIncludeAttribute |
讓 XmlSerializer 在對物件進行序列化或還原序列化時,能夠辨識型別。 |
XmlMapping |
支援 .NET 型別與 XML 結構描述資料型別之間的對應。 |
XmlMemberMapping |
將 .NET Web 服務方法中的程式碼實體對應至 Web 服務描述語言 (WSDL) 訊息中的元素。 |
XmlMembersMapping |
提供針對 SOAP Web 服務所定義、介於 .NET Web 服務方法和 Web 服務描述語言 (WSDL) 訊息之間的對應。 |
XmlNamespaceDeclarationsAttribute |
指定目標屬性、參數、傳回值或類別成員包含在 XML 文件中使用之命名空間關聯的前置詞。 |
XmlNodeEventArgs |
提供 UnknownNode 事件的資料。 |
XmlReflectionImporter |
針對 .NET 型別或 Web 服務方法資訊產生 XML 結構描述元素宣告的對應,包括 Web 服務描述語言 (WSDL) 文件中的常值 XML 結構描述定義 (XSD) 訊息部分。 |
XmlReflectionMember |
提供 .NET Web 服務方法中的程式碼實體與針對 SOAP Web 服務所定義之 Web 服務描述語言 (WSDL) 訊息內容之間的對應。 |
XmlRootAttribute |
控制做為 XML 根項目之屬性目標的 XML 序列化。 |
XmlSchemaEnumerator |
啟用對 XmlSchema 物件集合的反覆運算。 |
XmlSchemaExporter |
使用在型別對應物件中找到的 XML 結構描述項目宣告,填入 (Populate) XmlSchema 物件中。 |
XmlSchemaImporter |
針對 XML 結構描述元素宣告產生 .NET 型別的內部對應,包括 WSDL 文件中的常值 XSD 訊息部分。 |
XmlSchemaProviderAttribute |
套用至類型時,儲存傳回 XML 結構描述類型的靜態方法名稱,以及控制類型序列化的 XmlQualifiedName (匿名類型則為 XmlSchemaType)。 |
XmlSchemas |
代表 XML 結構描述的集合。 |
XmlSerializationGeneratedCode |
抽象類別,XmlSerializationReader 和 XmlSerializationWriter 的基底類別,包含這兩個型別的通用方法。 |
XmlSerializationReader |
依據 XmlSerializer 類別控制還原序列化。 |
XmlSerializationReader.CollectionFixup |
包含 XmlSerializationCollectionFixupCallback 委派 (Delegate) 執行個體,並加上方法的輸入,同時提供方法的參數。 |
XmlSerializationReader.Fixup |
存放一個 XmlSerializationFixupCallback 委派執行個體,加上此方法的輸入資料;同時也當做此方法的參數。 |
XmlSerializationWriter |
表示由 XmlSerializer 類別 (Class) 用來控制序列化 (Serialization) 的抽象類別。 |
XmlSerializer |
將物件序列化為 XML 文件,以及從 XML 文件將物件還原序列化。 XmlSerializer 可讓您控制如何將物件編碼為 XML。 |
XmlSerializerAssemblyAttribute |
套用至 Web 服務用戶端 Proxy 後,就可讓您指定含有自訂序列化程式的組件。 |
XmlSerializerFactory |
建立具型別版本的 XmlSerializer,以進行更有效率的序列化 (Serialization)。 |
XmlSerializerImplementation |
為預先產生且具類型的序列化程式定義讀取器、寫入器和方法。 |
XmlSerializerNamespaces |
將 XML 命名空間 (Namespace) 和 XmlSerializer 用來產生限定名稱的前置詞包含在 XML 文件執行個體中。 |
XmlSerializerVersionAttribute |
表示序列化 (Serialization) 基礎結構已產生程式碼,而且在這項屬性 (Attribute) 套用至組件 (Assembly) 時,可重複使用此程式碼來提升效能。 |
XmlTextAttribute |
表示 XmlSerializer 在序列化或還原序列化包含它的類別之後,應該將成員視為 XML 文字。 |
XmlTypeAttribute |
控制由 XmlSerializer 序列化屬性 (Attribute) 目標後所產生的 XML 結構描述。 |
XmlTypeMapping |
包含某個類型與其他類型的對應。 |
結構
XmlDeserializationEvents |
此類別所含欄位可將事件委派傳遞給 Deserialize 的安全執行緒 XmlSerializer 方法。 |
介面
IXmlSerializable |
為 XML 序列化和還原序列化提供自訂格式。 |
IXmlTextParser |
建立要讓 .NET 基礎結構使用的 Normalized 屬性。 |
列舉
CodeGenerationOptions |
指定在產生 .NET 類型以便搭配 XML Web Service 使用時要使用的各種選項。 |
XmlMappingAccess |
指定某個對應為讀取、寫入或兩者皆有。 |
委派
UnreferencedObjectEventHandler |
表示處理 UnreferencedObject 的 XmlSerializer 事件的方法。 |
XmlAttributeEventHandler |
表示處理 UnknownAttribute 的方法。 |
XmlElementEventHandler |
表示處理 UnknownElement 的 XmlSerializer 事件的方法。 |
XmlNodeEventHandler |
表示處理 UnknownNode 的 XmlSerializer 事件的方法。 |
XmlSerializationCollectionFixupCallback |
針對 SOAP 編碼之 XML 資料類型 (已對應至集合或列舉) 的還原序列化,XmlSerializer 類別所使用的委派。 |
XmlSerializationFixupCallback |
針對 SOAP 編碼之 XML 資料類型的還原序列化,XmlSerializer 類別所使用的委派。 |
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 至成員。 套用屬性時,您可以使用 屬性來指定詳細資料,例如實際的 XML 專案名稱 ElementName 。 如需所有屬性的完整清單,請參閱 XmlSerializer 類別概觀。