BinaryFormatter.Serialize 方法

定義

命名空間:

System.Runtime.Serialization.Formatters.Binary

組件:

mscorlib.dll

將物件或連接物件的圖序列化到給定的串流。

多載

名稱	Description
Serialize(Stream, Object)	將物件或具有指定頂端（根節點）的物件圖序列化到給定的串流。
Serialize(Stream, Object, Header[])	將物件或物件圖，將指定的頂端（根）序列化到附加標頭的給定串流上。

Serialize(Stream, Object)

將物件或具有指定頂端（根節點）的物件圖序列化到給定的串流。

public:
 virtual void Serialize(System::IO::Stream ^ serializationStream, System::Object ^ graph);

public void Serialize(System.IO.Stream serializationStream, object graph);

abstract member Serialize : System.IO.Stream * obj -> unit
override this.Serialize : System.IO.Stream * obj -> unit

Public Sub Serialize (serializationStream As Stream, graph As Object)

參數

serializationStream

Stream

圖要序列化的串流。

graph

Object

圖根節點的物件要序列化。

實作

Serialize(Stream, Object)

例外狀況

ArgumentNullException

serializationStream 是 null。

-或-

是 graph 零。

SerializationException

序列化過程中發生錯誤，例如參數中的 graph 物件未被標記為可序列化。

SecurityException

來電者沒有所需的權限。

NotSupportedException

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

PlatformNotSupportedException

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

備註

Warning

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

Serialize(Stream, Object, Header[])

將物件或物件圖，將指定的頂端（根）序列化到附加標頭的給定串流上。

public:
 virtual void Serialize(System::IO::Stream ^ serializationStream, System::Object ^ graph, cli::array <System::Runtime::Remoting::Messaging::Header ^> ^ headers);

public void Serialize(System.IO.Stream serializationStream, object graph, System.Runtime.Remoting.Messaging.Header[] headers);

abstract member Serialize : System.IO.Stream * obj * System.Runtime.Remoting.Messaging.Header[] -> unit
override this.Serialize : System.IO.Stream * obj * System.Runtime.Remoting.Messaging.Header[] -> unit

Public Sub Serialize (serializationStream As Stream, graph As Object, headers As Header())

參數

serializationStream

Stream

物件要序列化的串流。

graph

Object

圖根節點的物件要序列化。

headers

Header[]

序列化中包含遠端標頭。 可以是 null。

實作

Serialize(Stream, Object, Header[])

例外狀況

ArgumentNullException

serializationStream 是 null。

SerializationException

序列化過程中發生錯誤，例如參數中的 graph 物件未被標記為可序列化。

SecurityException

來電者沒有所需的權限。

備註

Warning

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

序列化過程包含序列化串流前端參數所提供的 headers 資訊。

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