SoapFormatter.Deserialize Metoda

Definicja

Przestrzeń nazw:

System.Runtime.Serialization.Formatters.Soap

Zestaw:

System.Runtime.Serialization.Formatters.Soap.dll

Deserializuje strumień do grafu obiektów.

Przeciążenia

Deserialize(Stream)	Deserializuje dane na podanym strumieniu i odtwarza graf obiektów.
Deserialize(Stream, HeaderHandler)	Deserializuje strumień do grafu obiektu z dowolnymi nagłówkami w tym strumieniu obsługiwanym przez dany HeaderHandlerelement .

Uwagi

Ważne

Wywoływanie tej metody z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj tę metodę tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Validate All Inputs (Weryfikowanie wszystkich danych wejściowych).

Deserialize(Stream)

Deserializuje dane na podanym strumieniu i odtwarza graf obiektów.

C#

public object Deserialize (System.IO.Stream serializationStream);

Parametry

serializationStream

Stream

Strumień zawierający dane do deserializacji.

Zwraca

Object

Górny obiekt deserializowanego grafu (root).

Implementuje

Deserialize(Stream)

Wyjątki

ArgumentNullException

serializationStream to null.

Przykłady

C#

using System;
using System.IO;
using System.Collections;
using System.Runtime.Serialization;

// Note: When building this code, you must reference the
// System.Runtime.Serialization.Formatters.Soap.dll assembly.
using System.Runtime.Serialization.Formatters.Soap;

class App
{
    [STAThread]
    static void Main()
    {
        Serialize();
        Deserialize();
    }

    static void Serialize()
    {
        // Create a hashtable of values that will eventually be serialized.
        Hashtable addresses = new Hashtable();
        addresses.Add("Jeff", "123 Main Street, Redmond, WA 98052");
        addresses.Add("Fred", "987 Pine Road, Phila., PA 19116");
        addresses.Add("Mary", "PO Box 112233, Palo Alto, CA 94301");

        // To serialize the hashtable (and its key/value pairs),
        // you must first open a stream for writing.
        // Use a file stream here.
        FileStream fs = new FileStream("DataFile.soap", FileMode.Create);

        // Construct a SoapFormatter and use it
        // to serialize the data to the stream.
        SoapFormatter formatter = new SoapFormatter();
        try
        {
            formatter.Serialize(fs, addresses);
        }
        catch (SerializationException e)
        {
            Console.WriteLine("Failed to serialize. Reason: " + e.Message);
            throw;
        }
        finally
        {
            fs.Close();
        }
    }

    static void Deserialize()
    {
        // Declare the hashtable reference.
        Hashtable addresses  = null;

        // Open the file containing the data that you want to deserialize.
        FileStream fs = new FileStream("DataFile.soap", FileMode.Open);
        try
        {
            SoapFormatter formatter = new SoapFormatter();

            // Deserialize the hashtable from the file and
            // assign the reference to the local variable.
            addresses = (Hashtable) formatter.Deserialize(fs);
        }
        catch (SerializationException e)
        {
            Console.WriteLine("Failed to deserialize. Reason: " + e.Message);
            throw;
        }
        finally
        {
            fs.Close();
        }

        // To prove that the table deserialized correctly,
        // display the key/value pairs to the console.
        foreach (DictionaryEntry de in addresses)
        {
            Console.WriteLine("{0} lives at {1}.", de.Key, de.Value);
        }
    }
}

Uwagi

W celu pomyślnego 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 z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Validate All Inputs (Weryfikowanie wszystkich danych wejściowych).

Deserialize(Stream, HeaderHandler)

Deserializuje strumień do grafu obiektu z dowolnymi nagłówkami w tym strumieniu obsługiwanym przez dany HeaderHandlerelement .

C#

public object Deserialize (System.IO.Stream serializationStream, System.Runtime.Remoting.Messaging.HeaderHandler handler);

Parametry

serializationStream

Stream

Strumień zawierający dane do deserializacji.

handler

HeaderHandler

Delegowanie do obsługi wszystkich nagłówków znalezionych w strumieniu. Może to być null.

Zwraca

Object

Górny obiekt deserializowanego grafu (root).

Implementuje

Deserialize(Stream, HeaderHandler)

Wyjątki

ArgumentNullException

serializationStream to null.

SerializationException

serializationStream obsługuje poszukiwania, a jego długość wynosi 0.

Uwagi

Nagłówki są używane tylko w przypadku określonych aplikacji komunikacji zdalniej. Parametr HeaderHandler jest jednym z dwóch sposobów zwracania nagłówków ze strumienia w formacie Zdalnego wywołania procedury protokołu SOAP (RPC). Drugą metodą jest użycie TopObject właściwości .

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

Obiekty TimeSpan są serializowane zgodnie z normą ISO 8601: 1998 5.5.3.2.1 "Alternatywna".

Ważne

Wywoływanie tej metody z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj tę metodę tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Validate All Inputs (Weryfikowanie wszystkich danych wejściowych).