SoapFormatter.Deserialize 方法

定義

將資料流還原序列化至物件圖形。Deserializes a stream into an object graph.

多載

Deserialize(Stream)

還原序列化在提供的資料流上的資料,並重新組合物件 Graph。Deserializes the data on the provided stream and reconstitutes the graph of objects.

Deserialize(Stream, HeaderHandler)

將資料流還原序列化至物件圖形中,使用指定的 HeaderHandler 處理該資料流中的任何標頭。Deserializes the stream into an object graph with any headers in that stream being handled by the given HeaderHandler.

備註

重要

使用不信任的資料呼叫此方法,會造成安全性上的風險。Calling this method with untrusted data is a security risk. 呼叫此方法時,請一律使用信任的資料。Call this method only with trusted data. 如需詳細資訊,請參閱資料驗證For more information, see Data Validation.

Deserialize(Stream)

還原序列化在提供的資料流上的資料,並重新組合物件 Graph。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

參數

serializationStream
Stream

資料流,包含要還原序列化的資料。The stream that contains the data to deserialize.

傳回

Object

還原序列化圖形的最上層物件 (根)。The top object of the deserialized graph (root).

實作

例外狀況

serializationStreamnullserializationStream is null.

範例

#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

備註

若要成功還原序列化,資料流程中的目前位置必須位於物件圖形的開頭。For successful deserialization, the current position in the stream must be at the beginning of the object graph.

重要

使用不信任的資料呼叫此方法,會造成安全性上的風險。Calling this method with untrusted data is a security risk. 呼叫此方法時,請一律使用信任的資料。Call this method only with trusted data. 如需詳細資訊,請參閱資料驗證For more information, see Data Validation.

適用於

Deserialize(Stream, HeaderHandler)

將資料流還原序列化至物件圖形中,使用指定的 HeaderHandler 處理該資料流中的任何標頭。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

參數

serializationStream
Stream

資料流,包含要還原序列化的資料。The stream that contains the data to deserialize.

handler
HeaderHandler

委派,用於處理在資料流上找到的任何標頭。Delegate to handle any headers found on the stream. 可以是 nullCan be null.

傳回

Object

還原序列化圖形的最上層物件 (根)。The top object of the deserialized graph (root).

實作

例外狀況

serializationStreamnullserializationStream is null.

serializationStream 支援搜尋,且它的長度為 0。serializationStream supports seeking, and its length is 0.

備註

標頭僅用於特定的遠端處理應用程式。Headers are used only for specific remoting applications. HeaderHandler參數是在 SOAP 遠端程序呼叫中從資料流程傳回標頭的兩種方式之一, (RPC) 格式。The HeaderHandler parameter is one of two ways to return headers from a stream in SOAP Remote Procedure Call (RPC) format. 另一種方式是使用 TopObject 屬性。The other way is to use the TopObject property.

若要成功還原序列化,資料流程中的目前位置必須位於物件圖形的開頭。For successful deserialization, the current position in the stream must be at the beginning of the object graph.

TimeSpan 序列化TimeSpan Serialization

TimeSpan 物件會根據 ISO 8601:1998區段5.5.3.2.1 「替代」標準進行序列化。TimeSpan objects are serialized according to the ISO 8601: 1998 section 5.5.3.2.1 "Alternative" standard.

重要

使用不信任的資料呼叫此方法,會造成安全性上的風險。Calling this method with untrusted data is a security risk. 呼叫此方法時,請一律使用信任的資料。Call this method only with trusted data. 如需詳細資訊,請參閱資料驗證For more information, see Data Validation.

適用於