BinaryFormatter.Deserialize 方法

定義

命名空間:

System.Runtime.Serialization.Formatters.Binary

組件:

mscorlib.dll

將串流反序列化成物件圖。

多載

名稱	Description
Deserialize(Stream)	將指定的串流反序列化成物件圖。
Deserialize(Stream, HeaderHandler)	將指定的串流反序列化成物件圖。 提供的 HeaderHandler 會處理該串流中的任何標頭。

備註

Important

使用不受信任的數據呼叫此方法是安全性風險。 僅使用信任的數據呼叫這個方法。 如需詳細資訊，請參閱 驗證所有輸入。

Deserialize(Stream)

將指定的串流反序列化成物件圖。

public:
 virtual System::Object ^ Deserialize(System::IO::Stream ^ serializationStream);

public object Deserialize(System.IO.Stream serializationStream);

abstract member Deserialize : System.IO.Stream -> obj
override this.Deserialize : System.IO.Stream -> obj

Public Function Deserialize (serializationStream As Stream) As Object

參數

serializationStream

Stream

用來反序列化物件圖的串流。

傳回

Object

物件圖的頂端（根節點）。

實作

Deserialize(Stream)

例外狀況

ArgumentNullException

serializationStream 是 null。

SerializationException

serializationStream支撐尋找，但長度為 0。

-或-

輸入串流並非一個完整 BinaryFormatter 序列化的有效載荷。

-或-

在將物件從輸入串流中反序列化時發生錯誤。

InnerException該財產可能包含更多關於根本原因的資訊。

SecurityException

來電者沒有所需的權限。

NotSupportedException

ASP.NET Core 5-8：除非專案檔案中重新啟用 BinaryFormatter 功能，否則總是會丟出。 欲了解更多資訊，請參閱 解決 BinaryFormatter 過時與停用錯誤。

PlatformNotSupportedException

.NET 9 及以後版本：所有版本皆適用。 欲了解更多資訊，請參閱 BinaryFormatter 遷移指南。

備註

Warning

BinaryFormatter 不安全且無法確保安全。 如需詳細資訊，請參閱 BinaryFormatter 安全性指南。

為了成功反序列化，串流中目前的位置必須位於物件圖的起始位置。

Important

使用不受信任的數據呼叫此方法是安全性風險。 僅使用信任的數據呼叫這個方法。 如需詳細資訊，請參閱 驗證所有輸入。

Deserialize(Stream, HeaderHandler)

將指定的串流反序列化成物件圖。 提供的 HeaderHandler 會處理該串流中的任何標頭。

public:
 virtual System::Object ^ Deserialize(System::IO::Stream ^ serializationStream, System::Runtime::Remoting::Messaging::HeaderHandler ^ handler);

public object Deserialize(System.IO.Stream serializationStream, System.Runtime.Remoting.Messaging.HeaderHandler handler);

abstract member Deserialize : System.IO.Stream * System.Runtime.Remoting.Messaging.HeaderHandler -> obj
override this.Deserialize : System.IO.Stream * System.Runtime.Remoting.Messaging.HeaderHandler -> obj

Public Function Deserialize (serializationStream As Stream, handler As HeaderHandler) As Object

參數

serializationStream

Stream

用來反序列化物件圖的串流。

handler

HeaderHandler

該 HeaderHandler 該 處理 . 中的任何標頭。serializationStream 可以是 null。

傳回

Object

反序列化的物件或物件圖的頂端物件（根節點）。

實作

Deserialize(Stream, HeaderHandler)

例外狀況

ArgumentNullException

serializationStream 是 null。

SerializationException

serializationStream支撐尋找，但長度為 0。

-或-

目標型別是 Decimal，但值不在該 Decimal 型別範圍內。

SecurityException

來電者沒有所需的權限。

備註

Warning

BinaryFormatter 不安全且無法確保安全。 如需詳細資訊，請參閱 BinaryFormatter 安全性指南。

標頭僅用於特定的遠端應用。

為了讓反序列化成功，串流中目前的位置必須位於物件圖的起始位置。

Important

使用不受信任的數據呼叫此方法是安全性風險。 僅使用信任的數據呼叫這個方法。 如需詳細資訊，請參閱 驗證所有輸入。