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)

Source:
BinaryFormatter.Core.cs
Source:
BinaryFormatter.Core.cs
Source:
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

位于要序列化图形的根位置的对象。

实现

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

位于要序列化图形的根位置的对象。

headers
Header[]

将包括在序列化中的远程处理标题。 可以为 null。

实现

Serialize(Stream, Object, Header[])

例外

ArgumentNullException

serializationStream 为 null。

SerializationException

序列化期间发生错误，如 graph 参数中的某个对象未标记为可序列化。

SecurityException

调用方没有所要求的权限。

注解

警告

BinaryFormatter 不安全，无法确保安全。 有关详细信息，请参阅 BinaryFormatter 安全指南。

序列化过程包括序列化流前面的 参数中 headers 提供的信息。

标头仅用于特定的远程处理应用程序。

适用于