BinaryFormatter.Serialize 方法

  • 參考

定義

命名空間:
System.Runtime.Serialization.Formatters.Binary
組件:
System.Runtime.Serialization.Formatters.dll
組件:
mscorlib.dll
組件:
netstandard.dll

將物件或連接之物件的圖形序列化至指定資料流。

多載

Serialize(Stream, Object)
已淘汰.

使用指定的最上層 (根)，將物件或物件的圖形序列化至指定的資料流。
Serialize(Stream, Object, Header[])

使用指定的最上層 (根)，將物件或物件的圖形序列化至附加所提供標頭的指定資料流。

Serialize(Stream, Object)

來源:
BinaryFormatter.Core.cs
來源:
BinaryFormatter.Core.cs
來源:
BinaryFormatter.Core.cs

警告

BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.

使用指定的最上層 (根)，將物件或物件的圖形序列化至指定的資料流。

public:
 virtual void Serialize(System::IO::Stream ^ serializationStream, System::Object ^ graph);
[System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public void Serialize (System.IO.Stream serializationStream, object graph);
public void Serialize (System.IO.Stream serializationStream, object graph);
[<System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
abstract member Serialize : System.IO.Stream * obj -> unit
override this.Serialize : System.IO.Stream * obj -> unit
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

物件，位在要序列化的 Graph 的根。

實作

Serialize(Stream, Object)
屬性
ObsoleteAttribute

例外狀況

ArgumentNullException

serializationStream 為 null。

-或-

graph 為 Null。

SerializationException

在序列化期間發生錯誤，例如在 graph 參數中的物件未標記為可序列化。

SecurityException

呼叫端沒有必要的權限。

NotSupportedException

ASP.NET Core 5 和更新版本：除非 BinaryFormatter 在專案檔中重新啟用功能，否則一律擲回 。 如需詳細資訊，請參閱解決 BinaryFormatter 過時與停用錯誤。

備註

警告

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

物件，位在要序列化的 Graph 的根。

headers
Header[]

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

實作

Serialize(Stream, Object, Header[])

例外狀況

ArgumentNullException

serializationStream 為 null。

SerializationException

在序列化期間發生錯誤，例如在 graph 參數中的物件未標記為可序列化。

SecurityException

呼叫端沒有必要的權限。

備註

警告

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

序列化套裝程式含序列化資料流程前端參數中 headers 提供的資訊。

標頭僅用於特定遠端處理應用程式。

適用於