SoapFormatter.Deserialize SoapFormatter.Deserialize SoapFormatter.Deserialize SoapFormatter.Deserialize Method

Definição

Desserializa um fluxo em um gráfico de objeto.Deserializes a stream into an object graph.

Sobrecargas

Deserialize(Stream) Deserialize(Stream) Deserialize(Stream) Deserialize(Stream)

Desserializa os dados no fluxo fornecido e reconstitui o grafo de objetos.Deserializes the data on the provided stream and reconstitutes the graph of objects.

Deserialize(Stream, HeaderHandler) Deserialize(Stream, HeaderHandler) Deserialize(Stream, HeaderHandler) Deserialize(Stream, HeaderHandler)

Desserializa o fluxo em um grafo de objeto com os cabeçalhos nesse fluxo manipulados pelo HeaderHandler especificado.Deserializes the stream into an object graph with any headers in that stream being handled by the given HeaderHandler.

Comentários

Importante

Chamar este método quando você tiver dados não confiáveis é um risco à segurança.Calling this method with untrusted data is a security risk. Chame esse método apenas quando você tiver dados confiáveis.Call this method only with trusted data. Para obter mais informações, confira Validação de dados.For more information, see Data Validation.

Deserialize(Stream) Deserialize(Stream) Deserialize(Stream) Deserialize(Stream)

Desserializa os dados no fluxo fornecido e reconstitui o grafo de objetos.Deserializes the data on the provided stream and reconstitutes the graph of objects.

public:
 virtual System::Object ^ Deserialize(System::IO::Stream ^ serializationStream);
public object Deserialize (System.IO.Stream serializationStream);
abstract member Deserialize : System.IO.Stream -> obj
override this.Deserialize : System.IO.Stream -> obj
Public Function Deserialize (serializationStream As Stream) As Object

Parâmetros

serializationStream
Stream Stream Stream Stream

O fluxo que contém os dados a serem desserializados.The stream that contains the data to deserialize.

Retornos

O objeto superior do gráfico desserializado (raiz).The top object of the deserialized graph (root).

Implementações

Exceções

serializationStream é null.serializationStream is null.

Exemplos

#using <system.dll>
#using <system.runtime.serialization.formatters.soap.dll>

using namespace System;
using namespace System::IO;
using namespace System::Collections;
using namespace System::Runtime::Serialization;
using namespace System::Runtime::Serialization::Formatters::Soap;
void Serialize()
{
   
   // Create a hashtable of values that will eventually be serialized.
   Hashtable^ addresses = gcnew 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 keys/values), 
   // you must first open a stream for writing.
   // We will use a file stream here.
   FileStream^ fs = gcnew FileStream( "DataFile.soap",FileMode::Create );
   
   // Construct a SoapFormatter and use it 
   // to serialize the data to the stream.
   SoapFormatter^ formatter = gcnew SoapFormatter;
   try
   {
      formatter->Serialize( fs, addresses );
   }
   catch ( SerializationException^ e ) 
   {
      Console::WriteLine( "Failed to serialize. Reason: {0}", e->Message );
      throw;
   }
   finally
   {
      fs->Close();
   }

}

void Deserialize()
{
   
   // Declare the hashtable reference.
   Hashtable^ addresses = nullptr;
   
   // Open the file containing the data that we want to deserialize.
   FileStream^ fs = gcnew FileStream( "DataFile.soap",FileMode::Open );
   try
   {
      SoapFormatter^ formatter = gcnew SoapFormatter;
      
      // Deserialize the hashtable from the file and 
      // assign the reference to our local variable.
      addresses = dynamic_cast<Hashtable^>(formatter->Deserialize( fs ));
   }
   catch ( SerializationException^ e ) 
   {
      Console::WriteLine( "Failed to deserialize. Reason: {0}", e->Message );
      throw;
   }
   finally
   {
      fs->Close();
   }

   
   // To prove that the table deserialized correctly, 
   // display the keys/values to the console.
   IEnumerator^ myEnum = addresses->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DictionaryEntry^ de = safe_cast<DictionaryEntry^>(myEnum->Current);
      Console::WriteLine( " {0} lives at {1}.", de->Key, de->Value );
   }
}


[STAThread]
int main()
{
   Serialize();
   Deserialize();
}

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);
        }
    }
}
Imports System.IO
Imports System.Collections
Imports System.Runtime.Serialization

' Note: When building this code, you must reference the
' System.Runtime.Serialization.Formatters.Soap.dll assembly.
Imports System.Runtime.Serialization.Formatters.Soap


Module App

   Sub Main()
      Serialize()
      Deserialize()
   End Sub

   Sub Serialize()
      ' Create a hashtable of values that will eventually be serialized.
      Dim addresses As 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.
      Dim fs As New FileStream("DataFile.soap", FileMode.Create)

      ' Construct a SoapFormatter and use it 
      ' to serialize the data to the stream.
      Dim formatter As New SoapFormatter
      Try
         formatter.Serialize(fs, addresses)
      Catch e As SerializationException
         Console.WriteLine("Failed to serialize. Reason: " & e.Message)
         Throw
      Finally
         fs.Close()
      End Try
   End Sub


   Sub Deserialize()
      ' Declare the hashtable reference.
      Dim addresses As Hashtable = Nothing

      ' Open the file containing the data that you want to deserialize.
      Dim fs As New FileStream("DataFile.soap", FileMode.Open)
      Try
         Dim formatter As New SoapFormatter

         ' Deserialize the hashtable from the file and 
         ' assign the reference to the local variable.
         addresses = DirectCast(formatter.Deserialize(fs), Hashtable)
      Catch e As SerializationException
         Console.WriteLine("Failed to deserialize. Reason: " & e.Message)
         Throw
      Finally
         fs.Close()
      End Try

      ' To prove that the table deserialized correctly, 
      ' display the key/value pairs to the console.
      Dim de As DictionaryEntry
      For Each de In addresses
         Console.WriteLine("{0} lives at {1}.", de.Key, de.Value)
      Next
   End Sub
End Module

Comentários

Para desserialização bem-sucedida, a posição atual no fluxo deve ser no início do grafo de objeto.For successful deserialization, the current position in the stream must be at the beginning of the object graph.

Importante

Chamar este método quando você tiver dados não confiáveis é um risco à segurança.Calling this method with untrusted data is a security risk. Chame esse método apenas quando você tiver dados confiáveis.Call this method only with trusted data. Para obter mais informações, confira Validação de dados.For more information, see Data Validation.

Deserialize(Stream, HeaderHandler) Deserialize(Stream, HeaderHandler) Deserialize(Stream, HeaderHandler) Deserialize(Stream, HeaderHandler)

Desserializa o fluxo em um grafo de objeto com os cabeçalhos nesse fluxo manipulados pelo HeaderHandler especificado.Deserializes the stream into an object graph with any headers in that stream being handled by the given HeaderHandler.

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

Parâmetros

serializationStream
Stream Stream Stream Stream

O fluxo que contém os dados a serem desserializados.The stream that contains the data to deserialize.

handler
HeaderHandler HeaderHandler HeaderHandler HeaderHandler

Delegado para manipular os cabeçalhos encontrados no fluxo.Delegate to handle any headers found on the stream. Pode ser null.Can be null.

Retornos

O objeto superior do gráfico desserializado (raiz).The top object of the deserialized graph (root).

Implementações

Exceções

serializationStream é null.serializationStream is null.

serializationStream dá suporte à busca e seu tamanho é 0.serializationStream supports seeking, and its length is 0.

Comentários

Cabeçalhos são usados somente para aplicativos de comunicação remota específica.Headers are used only for specific remoting applications. O HeaderHandler parâmetro é uma das duas maneiras para retornar os cabeçalhos de um fluxo no formato SOAP procedimento remoto (RPC).The HeaderHandler parameter is one of two ways to return headers from a stream in SOAP Remote Procedure Call (RPC) format. A outra maneira é usar o TopObject propriedade.The other way is to use the TopObject property.

Para desserialização bem-sucedida, a posição atual no fluxo deve ser no início do grafo de objeto.For successful deserialization, the current position in the stream must be at the beginning of the object graph.

Serialização de TimeSpanTimeSpan Serialization

Objetos TimeSpan são serializados de acordo com o ISO 8601: padrão de seção de 1998 5.5.3.2.1 "Alternativo".TimeSpan objects are serialized according to the ISO 8601: 1998 section 5.5.3.2.1 "Alternative" standard.

Importante

Chamar este método quando você tiver dados não confiáveis é um risco à segurança.Calling this method with untrusted data is a security risk. Chame esse método apenas quando você tiver dados confiáveis.Call this method only with trusted data. Para obter mais informações, confira Validação de dados.For more information, see Data Validation.

Aplica-se a