Udostępnij za pośrednictwem

BinaryFormatter.Serialize Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Runtime.Serialization.Formatters.Binary
Zestaw:
System.Runtime.Serialization.Formatters.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

Serializuje obiekt lub graf połączonych obiektów do danego strumienia.

Przeciążenia

Serialize(Stream, Object)
Przestarzałe.

Serializuje obiekt lub graf obiektów z określonym górnym (głównym) do danego strumienia.
Serialize(Stream, Object, Header[])

Serializuje obiekt lub graf obiektów z określonym górnym (głównym) do danego strumienia dołączającego podane nagłówki.

Serialize(Stream, Object)

Źródło:
BinaryFormatter.Core.cs
Źródło:
BinaryFormatter.Core.cs
Źródło:
BinaryFormatter.Core.cs

Przestroga

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

Serializuje obiekt lub graf obiektów z określonym górnym (głównym) do danego strumienia.

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)

Parametry

serializationStream
Stream

Strumień, do którego ma zostać zserializowany wykres.

graph
Object

Obiekt w katalogu głównym grafu do serializacji.

Implementuje

Serialize(Stream, Object)
Atrybuty
ObsoleteAttribute

Wyjątki

ArgumentNullException

Element serializationStream to null.

-lub-

Wartość graph ma wartość null.

SerializationException

Wystąpił błąd podczas serializacji, na przykład jeśli obiekt w parametrze graph nie jest oznaczony jako serializowalny.

SecurityException

Obiekt wywołujący nie posiada wymaganych uprawnień.

NotSupportedException

ASP.NET Core 5 lub nowszych: zawsze zgłaszany, chyba że BinaryFormatter funkcja zostanie ponownie włączona w pliku projektu. Aby uzyskać więcej informacji, zobacz Rozwiązywanie błędów binarnychFormatter obsoletion i wyłączanie.

Uwagi

Ostrzeżenie

BinaryFormatter jest niezabezpieczony i nie można go zabezpieczyć. Aby uzyskać więcej informacji, zobacz BinaryFormatter security guide (Przewodnik po zabezpieczeniach BinaryFormatter).

Dotyczy

Serialize(Stream, Object, Header[])

Serializuje obiekt lub graf obiektów z określonym górnym (głównym) do danego strumienia dołączającego podane nagłówki.

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

Parametry

serializationStream
Stream

Strumień, do którego ma zostać zserializowany obiekt.

graph
Object

Obiekt w katalogu głównym grafu do serializacji.

headers
Header[]

Komunikacja zdalna nagłówków do uwzględnienia w serializacji. Może to być null.

Implementuje

Serialize(Stream, Object, Header[])

Wyjątki

ArgumentNullException

Element serializationStream to null.

SerializationException

Wystąpił błąd podczas serializacji, na przykład jeśli obiekt w parametrze graph nie jest oznaczony jako serializowalny.

SecurityException

Obiekt wywołujący nie posiada wymaganych uprawnień.

Uwagi

Ostrzeżenie

BinaryFormatter jest niezabezpieczony i nie można go zabezpieczyć. Aby uzyskać więcej informacji, zobacz BinaryFormatter security guide (Przewodnik po zabezpieczeniach BinaryFormatter).

Proces serializacji zawiera informacje podane w parametrze headers na początku serializowanego strumienia.

Nagłówki są używane tylko w przypadku określonych aplikacji do komunikacji zdalnie.

Dotyczy