System.Runtime.Serialization 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
包含類別,可以用來序列化和還原序列化物件。 序列化 (Serialization) 是將物件或物件圖形轉換為用於對其他位置進行儲存或傳輸之位元組線性序列的程序。 還原序列化 (Deserialization) 是納入所儲存資訊並從其中重新建立物件的程序。
類別
CollectionDataContractAttribute |
當套用至集合型別時,就能夠自訂集合 Item 項目的規格。 這個屬性只能套用至由 DataContractSerializer 識別為有效、可序列化集合的型別。 |
ContractNamespaceAttribute |
指定資料合約的 CLR 命名空間和 XML 命名空間。 |
DataContractAttribute |
指定定義或實作資料合約的型別,可由序列化程式 (例如 DataContractSerializer) 加以序列化。 型別作者一定要定義型別的資料合約,才能讓型別能夠進行序列化。 |
DataContractResolver |
提供在序列化及還原序列化期間,以動態方式來回對應型別與 |
DataContractSerializer |
將某個型別的執行個體序列化及還原序列化成使用所提供資料合約的 XML 資料流或文件。 此類別無法獲得繼承。 |
DataContractSerializerExtensions |
提供設定和取得 ISerializationSurrogateProvider 的方法,以擴充 DataContractSerializer 類別。 |
DataContractSerializerSettings |
指定資料合約序列化程式設定。 |
DataMemberAttribute |
當套用至型別的成員時,便會指定該成員屬於資料合約的一部分,而且已由 DataContractSerializer 完成序列化。 |
DateTimeFormat |
指定日期時間格式選項。 |
EnumMemberAttribute |
指定欄位是列舉成員,並且應該加以序列化。 |
ExportOptions |
表示 XsdDataContractExporter 可以設定的選項。 |
ExtensionDataObject |
儲存已建立版本之資料合約的資料,此資料合約已因加入新成員而得到擴充。 |
Formatter |
將基本功能提供給 Common Language Runtime 序列化格式子 (Serialization Formatter)。 |
FormatterConverter |
表示 IFormatterConverter 介面的基底實作,該介面使用 Convert 類別和 IConvertible 介面。 |
FormatterServices |
提供靜態方法,協助序列化 (Serialization) Formatter 的實作。 此類別無法獲得繼承。 |
GeneratedXmlSerializers |
包含類別,可以用來序列化和還原序列化物件。 序列化 (Serialization) 是將物件或物件圖形轉換為用於對其他位置進行儲存或傳輸之位元組線性序列的程序。 還原序列化 (Deserialization) 是納入所儲存資訊並從其中重新建立物件的程序。 |
IgnoreDataMemberAttribute |
當套用至型別的成員時,會指定該成員不屬於資料合約的一部分,而且未序列化。 |
ImportOptions |
表示可以在 XsdDataContractImporter 上設定的選項。 |
InvalidDataContractException |
當 DataContractSerializer 或 NetDataContractSerializer 在序列化 (Serialization) 和還原序列化 (Deserialization) 期間遇到無效的資料合約時,所擲回的例外狀況。 |
KnownTypeAttribute |
指定在序列化或還原序列化指定型別時,應該要由 DataContractSerializer 辨識的型別。 |
NetDataContractSerializer |
將某個類型的執行個體序列化及還原序列化成使用所提供 .NET Framework 類型的 XML 資料流或文件。 此類別無法獲得繼承。 |
ObjectIDGenerator |
產生物件的 ID。 |
ObjectManager |
在物件還原序列化時保持追蹤。 |
OnDeserializedAttribute |
套用至方法時,指定在還原序列化物件圖形中的物件後立即呼叫該方法。 還原序列化相對於圖形中其他物件的順序不具決定性。 |
OnDeserializingAttribute |
套用至方法時,指定在還原序列化物件圖形中的物件期間呼叫該方法。 還原序列化相對於圖形中其他物件的順序不具決定性。 |
OnSerializedAttribute |
套用至方法時,指定在還原序列化物件圖形中的物件後呼叫該方法。 序列化相對於圖形中其他物件的順序不具決定性。 |
OnSerializingAttribute |
套用至方法時,指定在物件圖形中物件序列化期間呼叫 方法。 序列化相對於圖形中其他物件的順序不具決定性。 |
OptionalFieldAttribute |
指定可從序列化 (Serialization) 資料流中遺漏欄位,使 BinaryFormatter 和 SoapFormatter 不會擲回例外狀況。 |
SafeSerializationEventArgs |
提供 SerializeObjectState 事件的資料。 |
SerializationBinder |
允許使用者控制類別的載入,並且託管要載入的類別。 |
SerializationException |
當序列化或還原序列化期間發生錯誤時,所擲回的例外狀況。 |
SerializationInfo |
儲存序列化或還原序列化物件所需的所有資料。 此類別無法獲得繼承。 |
SerializationInfoEnumerator |
提供用於剖析 SerializationInfo 中資料的格式器友善機制。 此類別無法獲得繼承。 |
SerializationObjectManager |
在執行階段管理序列化處理序。 此類別無法獲得繼承。 |
SurrogateSelector |
在序列化 (Serialization) 代理的選取方面協助格式子 (Formatter),以委派 (Delegate) 序列化或還原序列化 (Deserialization) 處理序。 |
XmlObjectSerializer |
提供用來將物件序列化為 XML 資料流或文件的基底類別。 這個類別是抽象的。 |
XmlSerializableServices |
包含讀取和寫入 XML 的方法。 |
XPathQueryGenerator |
當提供代表資料合約的類別,以及代表合約成員的中繼資料時,會產生該成員的 XPath 查詢。 |
XsdDataContractExporter |
允許將資料合約中使用的一組 .NET 型別轉換成 XML 結構描述檔案 (.xsd)。 |
XsdDataContractImporter |
允許將 XML 結構描述檔案 (.xsd) 集合轉換為 Common Language Runtime (CLR) 型別。 |
結構
SerializationEntry |
存留該值、Type 和已序列化物件的名稱。 |
StreamingContext |
描述給定序列化資料流的來源和目的端,並且提供其他呼叫端定義的內容。 |
介面
IDataContractSurrogate |
提供 DataContractSerializer 在序列化 (Serialization)、還原序列化 (Deserialization),以及匯出和匯入 XML 結構描述文件 (XSD) 期間,必須用來將型別取代成另一種型別的方法。 |
IDeserializationCallback |
指示在整個物件 Graph 的還原序列化 (Deserialization) 完成時告知類別。 當您使用 XmlSerializer 還原序列化時,不會呼叫這個介面。 |
IExtensibleDataObject |
提供資料結構,以便儲存 XmlObjectSerializer 在還原序列化標記有 DataContractAttribute 屬性的型別時所遇到的額外資料。 |
IFormatter |
提供用於格式化已序列化物件的功能。 |
IFormatterConverter |
提供 SerializationInfo 執行個體 (Instance) 和格式子提供類別之間的連接,最適用於在 SerializationInfo 中剖析資料。 |
IObjectReference |
指示目前的介面實作器是對其他物件的參考。 |
ISafeSerializationData |
在安全性透明程式碼中啟用自訂例外狀況資料序列化。 |
ISerializable |
允許物件透過二進位和 XML 序列化來控制自己的序列化和還原序列化。 |
ISerializationSurrogate |
實作允許一個物件執行另一個物件序列化 (Serialization) 和還原序列化 (Deserialization) 的序列化代理選取器。 |
ISerializationSurrogateProvider |
提供建構擴充 DataContractSerializer 的序列化代理所需之方法。 在序列化及還原序列化期間,會使用序列化代理將類型替代為其他類型。 |
ISerializationSurrogateProvider2 |
提供在匯出和匯入 XML 架構檔 (XSD) 期間,DataContractSerializer 替代另一種類型所需的方法。 這個介面建置在 上 ISerializationSurrogateProvider 。 |
ISurrogateSelector |
指示序列化 (Serialization) 代理選取器類別。 |
列舉
EmitTypeInformation |
指定發出型別資訊的頻率。 |
StreamingContextStates |
定義一組旗標,指定序列化期間資料流的來源或目的內容。 |
備註
ISerializable 介面會提供方法,讓類別控制它們自己的序列化行為。 命名空間中的 System.Runtime.Serialization.Formatters 類別可控制序列化物件中封裝的各種資料類型的實際格式。
您可以在 命名空間中找到 System.Runtime.Serialization.Formatters 序列化和還原序列化物件與特定格式的格式器。
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應