Compartilhar via

BinaryFormatter.Serialize Método

  • Referência

Definição

Namespace:
System.Runtime.Serialization.Formatters.Binary
Assembly:
System.Runtime.Serialization.Formatters.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Serializa um objeto, ou o gráfico de objetos conectados, para o fluxo determinado.

Sobrecargas

Serialize(Stream, Object)
Obsoleto.

Serializa o objeto ou grafo de objetos com o topo (raiz) especificado para o fluxo especificado.
Serialize(Stream, Object, Header[])

Serializa o objeto ou o grafo de objetos com o topo (raiz) especificado para o fluxo determinado, anexando os cabeçalhos fornecidos.

Serialize(Stream, Object)

Origem:
BinaryFormatter.Core.cs
Origem:
BinaryFormatter.Core.cs
Origem:
BinaryFormatter.Core.cs

Cuidado

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

Serializa o objeto ou grafo de objetos com o topo (raiz) especificado para o fluxo especificado.

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)

Parâmetros

serializationStream
Stream

O fluxo para o qual o gráfico deve ser serializado.

graph
Object

O objeto na raiz do grafo a ser serializado.

Implementações

Serialize(Stream, Object)
Atributos
ObsoleteAttribute

Exceções

ArgumentNullException

O serializationStream é null.

- ou -

O graph é nulo.

SerializationException

Ocorreu um erro durante a serialização; por exemplo, se um objeto no parâmetro graph não foi marcado como serializável.

SecurityException

O chamador não tem a permissão necessária.

NotSupportedException

ASP.NET Core 5 e posterior: sempre gerada, BinaryFormatter a menos que a funcionalidade seja habilitada novamente no arquivo de projeto. Para obter mais informações, confira Resolver erros de desabilitação e obsolescência do BinaryFormatter.

Comentários

Aviso

BinaryFormatter não é seguro e não pode ser transformado em seguro. Para saber mais, confira o Guia de segurança do BinaryFormatter.

Aplica-se a

Serialize(Stream, Object, Header[])

Serializa o objeto ou o grafo de objetos com o topo (raiz) especificado para o fluxo determinado, anexando os cabeçalhos fornecidos.

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())

Parâmetros

serializationStream
Stream

O fluxo no qual o objeto será serializado.

graph
Object

O objeto na raiz do grafo a ser serializado.

headers
Header[]

Cabeçalhos de comunicação remota a serem incluídos na serialização. Pode ser null.

Implementações

Serialize(Stream, Object, Header[])

Exceções

ArgumentNullException

O serializationStream é null.

SerializationException

Ocorreu um erro durante a serialização; por exemplo, se um objeto no parâmetro graph não foi marcado como serializável.

SecurityException

O chamador não tem a permissão necessária.

Comentários

Aviso

BinaryFormatter não é seguro e não pode ser transformado em seguro. Para saber mais, confira o Guia de segurança do BinaryFormatter.

O processo de serialização inclui as informações fornecidas no headers parâmetro na frente do fluxo serializado.

Os cabeçalhos são usados apenas para aplicativos de comunicação remota específicos.

Aplica-se a