System.Xml.Serialization 命名空間

包含類別,用來將物件序列化為 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 <part> 項目的特定屬性,可從文件產生類別。

SoapTypeAttribute

控制類別執行個體被序列化為 SOAP 編碼 XML 時,XmlSerializer 所產生的結構描述。

UnreferencedObjectEventArgs

提供在還原序列化 (Deserialization) 時,於編碼 SOAP XML 資料流中發現之已知,但是未被參考到的物件。

XmlAnyAttributeAttribute

指定成員 (傳回 XmlAttribute 物件陣列的欄位) 可以包含任何 XML 屬性。

XmlAnyElementAttribute

指定成員 (傳回 XmlElementXmlNode 物件陣列的欄位) 包含物件,該物件表示在序列化或還原序列化物件中沒有對應成員的任何 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

抽象類別,XmlSerializationReaderXmlSerializationWriter 的基底類別,包含這兩個型別的通用方法。

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

表示處理 UnreferencedObjectXmlSerializer 事件的方法。

XmlAttributeEventHandler

表示處理 UnknownAttribute 的方法。

XmlElementEventHandler

表示處理 UnknownElementXmlSerializer 事件的方法。

XmlNodeEventHandler

表示處理 UnknownNodeXmlSerializer 事件的方法。

XmlSerializationCollectionFixupCallback

針對 SOAP 編碼之 XML 資料類型 (已對應至集合或列舉) 的還原序列化,XmlSerializer 類別所使用的委派。

XmlSerializationFixupCallback

針對 SOAP 編碼之 XML 資料類型的還原序列化,XmlSerializer 類別所使用的委派。

XmlSerializationReadCallback

XmlSerializer 類別對 SOAP 編碼的非根 XML 資料進行類型還原序列化時所使用的委派。

XmlSerializationWriteCallback

XmlSerializer 類別對 SOAP 編碼之非根 XML 資料中的型別進行序列化時所使用的委派。

備註

命名空間中的中央類別是 XmlSerializer 類別。 若要使用此類別,請使用 XmlSerializer 建構函式,使用 物件的型別來建立 類別的實例來序列化。 XmlSerializer建立 之後,請建立 要序列化的 物件實例。 您也必須建立 物件,以將檔案寫入檔或資料流程,例如 StreamTextWriterXmlWriter 。 然後,您可以呼叫 Serialize 方法,將物件轉換成 XML 檔。

若要從 XML 檔案還原序列化物件,請建立適當的物件,以再次讀取檔或資料流程 (、 StreamTextWriterXmlWriter) 。 將 Deserialize 產生的物件轉換成序列化) 的原始物件類型 (時,叫用 方法。

為了進一步控制序列化, System.Xml.Serialization 命名空間包含數 Attribute 個可套用至類別成員的類別。 例如,如果類別包含將序列化為 XML 元素的成員,您可以將 屬性套用 XmlElementAttribute 至成員。 套用 屬性時,您可以使用 屬性來指定詳細資料,例如實際的 XML 專案名稱 ElementName 。 如需所有屬性的完整清單,請參閱 XmlSerializer 類別概觀。