Udostępnij za pośrednictwem

BinaryFormatter.Deserialize Metoda

  • Odwołanie

Definicja

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

Deserializuje strumień do grafu obiektu.

Przeciążenia

Deserialize(Stream)
Przestarzałe.

Deserializuje określony strumień do grafu obiektu.
Deserialize(Stream, HeaderHandler)

Deserializuje określony strumień do grafu obiektu. Podana usługa HeaderHandler obsługuje wszystkie nagłówki w tym strumieniu.

Uwagi

Ważne

Wywoływanie tej metody z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj tę metodę tylko przy użyciu zaufanych danych. Aby uzyskać więcej informacji, zobacz Weryfikowanie wszystkich danych wejściowych.

Deserialize(Stream)

Ź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.

Deserializuje określony strumień do grafu obiektu.

public:
 virtual System::Object ^ Deserialize(System::IO::Stream ^ serializationStream);
[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 object Deserialize (System.IO.Stream serializationStream);
public object Deserialize (System.IO.Stream serializationStream);
[<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 Deserialize : System.IO.Stream -> obj
override this.Deserialize : System.IO.Stream -> obj
abstract member Deserialize : System.IO.Stream -> obj
override this.Deserialize : System.IO.Stream -> obj
Public Function Deserialize (serializationStream As Stream) As Object

Parametry

serializationStream
Stream

Strumień, z którego ma wykonać deserializowanie grafu obiektu.

Zwraca

Object

Górna (główna) grafu obiektu.

Implementuje

Deserialize(Stream)
Atrybuty
ObsoleteAttribute

Wyjątki

ArgumentNullException

Element serializationStream to null.

SerializationException

Wspiera serializationStream poszukiwania, ale jego długość wynosi 0.

-lub-

Strumień wejściowy nie reprezentuje dobrze sformułowanego BinaryFormatter serializowanego ładunku.

-lub-

Wystąpił błąd podczas deserializacji obiektu ze strumienia wejściowego.

Właściwość InnerException może zawierać więcej informacji o głównej przyczynie.

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

W przypadku pomyślnej deserializacji bieżąca pozycja w strumieniu musi znajdować się na początku grafu obiektu.

Ważne

Wywoływanie tej metody z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj tę metodę tylko przy użyciu zaufanych danych. Aby uzyskać więcej informacji, zobacz Weryfikowanie wszystkich danych wejściowych.

Dotyczy

Deserialize(Stream, HeaderHandler)

Deserializuje określony strumień do grafu obiektu. Podana usługa HeaderHandler obsługuje wszystkie nagłówki w tym strumieniu.

public:
 virtual System::Object ^ Deserialize(System::IO::Stream ^ serializationStream, System::Runtime::Remoting::Messaging::HeaderHandler ^ handler);
public object Deserialize (System.IO.Stream serializationStream, System.Runtime.Remoting.Messaging.HeaderHandler handler);
abstract member Deserialize : System.IO.Stream * System.Runtime.Remoting.Messaging.HeaderHandler -> obj
override this.Deserialize : System.IO.Stream * System.Runtime.Remoting.Messaging.HeaderHandler -> obj
Public Function Deserialize (serializationStream As Stream, handler As HeaderHandler) As Object

Parametry

serializationStream
Stream

Strumień, z którego ma wykonać deserializowanie grafu obiektu.

handler
HeaderHandler

Element HeaderHandler , który obsługuje wszystkie nagłówki w elemecie serializationStream. Może to być null.

Zwraca

Object

Deserializowany obiekt lub górny obiekt (główny) grafu obiektu.

Implementuje

Deserialize(Stream, HeaderHandler)

Wyjątki

ArgumentNullException

Element serializationStream to null.

SerializationException

Wspiera serializationStream poszukiwania, ale jego długość wynosi 0.

-lub-

Typ docelowy to Decimal, ale wartość jest poza zakresem Decimal typu.

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

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

Aby deserializacja powiodła się, bieżąca pozycja w strumieniu musi znajdować się na początku grafu obiektu.

Ważne

Wywoływanie tej metody z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj tę metodę tylko przy użyciu zaufanych danych. Aby uzyskać więcej informacji, zobacz Weryfikowanie wszystkich danych wejściowych.

Dotyczy