BinaryFormatter.Serialize Methode

  • Referenz

Definition

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

Serialisiert ein Objekt oder ein Diagramm verbundener Objekte in den angegebenen Stream.

Überlädt

Serialize(Stream, Object)
Veraltet.

Serialisiert das Objekt oder das Objektdiagramm mit dem angegebenen obersten Element (Stamm) in den angegebenen Stream.
Serialize(Stream, Object, Header[])

Serialisiert das Objekt bzw. das Objektdiagramm mit dem angegebenen obersten Element (Stamm) in den angegebenen Stream, wobei die bereitgestellten Header angefügt werden.

Serialize(Stream, Object)

Quelle:
BinaryFormatter.Core.cs
Quelle:
BinaryFormatter.Core.cs
Quelle:
BinaryFormatter.Core.cs

Achtung

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

Serialisiert das Objekt oder das Objektdiagramm mit dem angegebenen obersten Element (Stamm) in den angegebenen Stream.

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)

Parameter

serializationStream
Stream

Der Stream, in den das Diagramm serialisiert werden soll.

graph
Object

Das Stammobjekt des zu serialisierenden Diagramms.

Implementiert

Serialize(Stream, Object)
Attribute
ObsoleteAttribute

Ausnahmen

ArgumentNullException

serializationStream ist null.

- oder -

Die graph ist NULL.

SerializationException

Während der Serialisierung ist ein Fehler aufgetreten, z. B. ist ein Objekt im graph-Parameter nicht als serialisierbar markiert.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

NotSupportedException

ASP.NET Core 5 und höher: Wird immer ausgelöst, es sei dennBinaryFormatter, die Funktionalität wird in der Projektdatei wieder aktiviert. Weitere Informationen finden Sie unter Resolving BinaryFormatter obsoletion and disablement errors (Auflösen von Fehlern aufgrund der Veraltung und Deaktivierung von BinaryFormatter).

Hinweise

Warnung

BinaryFormatter ist unsicher und kann nicht sicher gemacht werden. Weitere Informationen finden Sie im Sicherheitsleitfaden für BinaryFormatter.

Gilt für:

Serialize(Stream, Object, Header[])

Serialisiert das Objekt bzw. das Objektdiagramm mit dem angegebenen obersten Element (Stamm) in den angegebenen Stream, wobei die bereitgestellten Header angefügt werden.

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

Parameter

serializationStream
Stream

Der Stream, in den das Objekt serialisiert werden soll.

graph
Object

Das Stammobjekt des zu serialisierenden Diagramms.

headers
Header[]

Remoteheader, die in die Serialisierung eingeschlossen werden sollen. Kann null sein.

Implementiert

Serialize(Stream, Object, Header[])

Ausnahmen

ArgumentNullException

serializationStream ist null.

SerializationException

Während der Serialisierung ist ein Fehler aufgetreten, z. B. ist ein Objekt im graph-Parameter nicht als serialisierbar markiert.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

Warnung

BinaryFormatter ist unsicher und kann nicht sicher gemacht werden. Weitere Informationen finden Sie im Sicherheitsleitfaden für BinaryFormatter.

Der Serialisierungsprozess enthält die Informationen, die headers im Parameter an der Vorderseite des serialisierten Datenstroms bereitgestellt werden.

Header werden nur für bestimmte Remotinganwendungen verwendet.

Gilt für: