SoapFormatter Klasa

Definicja

Przestrzeń nazw:

System.Runtime.Serialization.Formatters.Soap

Zestaw:

System.Runtime.Serialization.Formatters.Soap.dll

Serializuje i deserializuje obiekt lub cały graf połączonych obiektów w formacie SOAP.

public ref class SoapFormatter sealed : System::Runtime::Remoting::Messaging::IRemotingFormatter

public sealed class SoapFormatter : System.Runtime.Remoting.Messaging.IRemotingFormatter

type SoapFormatter = class
    interface IRemotingFormatter
    interface IFormatter

Public NotInheritable Class SoapFormatter
Implements IRemotingFormatter

Dziedziczenie

Object

SoapFormatter

Implementuje

IRemotingFormatter IFormatter

Przykłady

#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

Uwagi

Uwaga

Począwszy od .NET Framework 2.0, ta klasa jest przestarzała.

Ostrzeżenie

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

Klasy SoapFormatter i BinaryFormatter implementują IRemotingFormatter interfejs do obsługi zdalnych wywołań procedur (RPCs) i IFormatter interfejsu (dziedziczonego przez klasę IRemotingFormatter) do obsługi serializacji grafu obiektów. Klasa SoapFormatter obsługuje również elementy RPCs z obiektami ISoapMessage bez korzystania z IRemotingFormatter funkcji.

Podczas funkcji RPCs IRemotingFormatter interfejs umożliwia specyfikację dwóch oddzielnych grafów obiektów: graf obiektów do serializacji oraz dodatkowy graf zawierający tablicę obiektów nagłówka, które przekazują informacje o zdalnym wywołaniu funkcji (na przykład identyfikator transakcji lub podpis metody). W przypadku odpowiedniej serializacji główny obiekt pierwszego grafu musi być obiektem implementujący IMethodCallMessage interfejs lub IMethodReturnMessage interfejs.

Podczas deserializacji RPC HeaderHandler delegat jest określony do Deserialize metody formatującego. Infrastruktura komunikacji zdalnie używa delegata HeaderHandler do tworzenia obiektu obsługującego ISerializable interfejs. Ten obiekt zawiera informacje przechowywane w nagłówkach i staje się głównym elementem grafu zwróconym przez deserializator.

Obiekt SoapFormatter może również obsługiwać elementy RPC, które są tworzone za pomocą obiektów implementujących ISoapMessage interfejs. Aby utworzyć RPC bez korzystania z IRemotingFormatter funkcji, umieść obiekt, który obsługuje ISoapMessage interfejs w katalogu głównym grafu serializowanego. Aby deserializować wywołanie RPC utworzone w ten sposób, TopObject właściwość musi być ustawiona na inny obiekt, który obsługuje ISoapMessage interfejs, i zawiera odpowiednie informacje o wywołaniu zdalnym.

Obiekty przedziału czasowego są serializowane zgodnie z normą ISO 8601: 1998 5.5.3.2.1 "Alternatywna".

Konstruktory

SoapFormatter()	Inicjuje SoapFormatter nowe wystąpienie klasy z domyślnymi wartościami właściwości.
SoapFormatter(ISurrogateSelector, StreamingContext)	Inicjuje SoapFormatter nowe wystąpienie klasy o określonej wartości ISurrogateSelector i StreamingContext.

Właściwości

AssemblyFormat	Pobiera lub ustawia zachowanie deserializatora w odniesieniu do znajdowania i ładowania zestawów.
Binder	Pobiera lub ustawia SerializationBinder , który kontroluje powiązanie obiektu serializowanego na typ.
Context	Pobiera lub ustawia użyte w StreamingContext tym SoapFormatterobiekcie .
FilterLevel	Pobiera lub ustawia automatyczną TypeFilterLevel deserializacji na potrzeby komunikacji zdalnie .NET Framework.
SurrogateSelector	Pobiera lub ustawia SurrogateSelector , że określa podstawianie typów podczas serializacji i deserializacji.
TopObject	Pobiera lub ustawia ISoapMessage obiekt, w którym obiekt top protokołu SOAP jest deserializowany.
TypeFormat	Pobiera lub ustawia format, w którym opisy typów są określone w strumieniu serializowanym.

Metody

Deserialize(Stream)	Deserializuje dane w podanym strumieniu i odtwarza wykres obiektów.
Deserialize(Stream, HeaderHandler)	Deserializuje strumień do grafu obiektu z dowolnymi nagłówkami w tym strumieniu obsługiwanymi przez daną HeaderHandlerwartość .
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Serialize(Stream, Object)	Serializuje obiekt lub graf obiektów z określonym katalogiem głównym dla danego Streamelementu .
Serialize(Stream, Object, Header[])	Serializuje obiekt lub graf obiektów z określonym katalogiem głównym podanym Stream w formacie protokołu SOAP Remote Procedure Call (RPC).
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)