Exportar (0) Imprimir
Expandir todo

SoapFormatter (Clase)

Actualización: noviembre 2007

Serializa o deserializa un objeto o todo un gráfico de objetos conectados, en formato SOAP.

Espacio de nombres:  System.Runtime.Serialization.Formatters.Soap
Ensamblado:  System.Runtime.Serialization.Formatters.Soap (en System.Runtime.Serialization.Formatters.Soap.dll)

public sealed class SoapFormatter : IRemotingFormatter, 
	IFormatter
public final class SoapFormatter implements IRemotingFormatter, 
	IFormatter
public final class SoapFormatter implements IRemotingFormatter, IFormatter

5ktza7xf.alert_note(es-es,VS.90).gifNota:

A partir de .NET Framework versión 3.5, esta clase está obsoleta. Utilice el método BinaryFormatter en su lugar.

Las clases SoapFormatter y BinaryFormatter implementan la interfaz IRemotingFormatter para que se admitan las llamadas a procedimientos remotos (RPC), y la interfaz IFormatter (heredada por IRemotingFormatter) para que se admita la serialización de un gráfico de objetos. La clase SoapFormatter también admite llamadas RPC con objetos ISoapMessage, sin utilizar la funcionalidad de IRemotingFormatter.

Durante las llamadas RPC, la interfaz IRemotingFormatter permite que se especifiquen dos gráficos de objetos diferentes: el gráfico de objetos que se va a serializar y un gráfico adicional que contiene una matriz de objetos de encabezado que transmiten información sobre la llamada a la función remota (por ejemplo, un identificador de transacción o una firma de método). Para que la serialización sea correcta, el objeto raíz del primer gráfico debe implementar la interfaz IMethodCallMessage o IMethodReturnMessage.

Durante la deserialización de una RPC, se especifica un delegado de HeaderHandler para el método Deserialize del formateador. La infraestructura de comunicación remota utiliza el delegado de HeaderHandler para crear un objeto que admite la interfaz ISerializable. Este objeto contiene la información almacenada en los encabezados y se convierte en la raíz del gráfico devuelto por el deserializador.

SoapFormatter también puede controlar las llamadas RPC generadas con objetos que implementan la interfaz ISoapMessage. Para crear una llamada RPC sin utilizar la funcionalidad de IRemotingFormatter, coloque un objeto que admita la interfaz ISoapMessage en la raíz del gráfico que se va a serializar. Para deserializar una llamada RPC creada de esta forma, la propiedad TopObject debe establecerse en otro objeto que admita la interfaz ISoapMessage y que contenga la información relevante sobre la llamada remota.

Serialización de TimeSpan

Los objetos TimeSpan se serializan según la norma "Alternativa" ISO 8601: 1998 sección 5.5.3.2.1.

Información de versión

SoapFormatter no admite la compatibilidad de serialización entre distintas versiones de .NET Framework. La serialización entre los tipos de las versiones 1.1 y 2.0 de Framework suele producir errores a menudo. Se pueden tomar las medidas siguientes para solucionar este problema:

  • Realizar la conversión para utilizar BinaryFormatter, que proporciona compatibilidad entre las versiones 1.1 y 2.0.

  • Convertir los datos conservados existentes al nuevo formato.

  • Convertir todos los productores y consumidores de datos serializados a la versión 2.0.

  • Evitar el uso de los tipos que han cambiado de la versión 1.1 a la 2.0.

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);
        }
    }
}


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

class App
{
    /** @attribute STAThread()
     */
    public static void main(String[] args) throws SerializationException
    {
        Serialize();
        Deserialize();
    } //main

    static void Serialize() throws SerializationException
    {
        // 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.get_Message());
            throw e;
        }
        finally {
            fs.Close();
        }
    } //Serialize

    static void Deserialize() throws SerializationException
    {
        // 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.get_Message());
            throw e;
        }
        finally {
            fs.Close();
        }

        // To prove that the table deserialized correctly, 
        // display the key/value pairs to the console.
        IEnumerator myEnumerator = addresses.GetEnumerator();
        while (myEnumerator.MoveNext()) {
            DictionaryEntry de = (DictionaryEntry)myEnumerator.get_Current();
            Console.WriteLine("{0} lives at {1}.", de.get_Key(), 
                de.get_Value());
        }
    } //Deserialize
} //App


System.Object
  System.Runtime.Serialization.Formatters.Soap.SoapFormatter

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft