Поделиться через

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

Объект в корне сериализуемого графа.

Реализации

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 в передней части сериализованного потока.

Заголовки используются только для определенных приложений удаленного взаимодействия.

Применяется к