SoapFormatter Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.Serialization.Formatters.Soap

Zestaw:: System.Runtime.Serialization.Formatters.Soap.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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 niepewny i nie można go zabezpieczyć. Aby uzyskać więcej informacji, zobacz Przewodnik po zabezpieczeniach BinaryFormatter.

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

Podczas wywołań RPC IRemotingFormatter interfejs umożliwia specyfikację dwóch oddzielnych grafów obiektów: grafu obiektów do serializacji i dodatkowego grafu zawierającego tablicę obiektów nagłówka, które przekazują informacje o zdalnym wywołaniu funkcji (na przykład identyfikator transakcji lub podpis metody). W celu zapewnienia 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 utworzenia obiektu obsługującego ISerializable interfejs. Ten obiekt zawiera informacje przechowywane w nagłówkach i staje się elementem głównym grafu zwróconego przez deserializator.

Może SoapFormatter również obsługiwać wywołania procedury RPC generowane za pomocą obiektów implementujących ISoapMessage interfejs. Aby utworzyć RPC bez korzystania z IRemotingFormatter funkcji, umieść obiekt obsługujący ISoapMessage interfejs w katalogu głównym grafu serializowanego. Aby wykonać deserializowanie wywołania RPC utworzonego w ten sposób, TopObject właściwość musi być ustawiona na inny obiekt obsługujący ISoapMessage interfejs i zawiera odpowiednie informacje o zdalnym wywołaniu.

Obiekty TimeSpan 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 z określonymi ISurrogateSelector parametrami 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 wartość używaną StreamingContext z tym SoapFormatterelementem .
FilterLevel	Pobiera lub ustawia TypeFilterLevel automatyczne deserializacja na potrzeby komunikacji zdalniej .NET Framework.
SurrogateSelector	Pobiera lub ustawia SurrogateSelector podstawianie typów podczas serializacji i deserializacji.
TopObject	Pobiera lub ustawia obiekt ISoapMessage , do którego obiekt top 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 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 .
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 wartość bieżącego wystąpienia. (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 elementem głównym dla danego Streamelementu .
Serialize(Stream, Object, Header[])	Serializuje obiekt lub graf obiektów z określonym elementem głównym do podanego Stream w formacie wywołania procedury zdalnej protokołu SOAP (RPC).
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy