Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

BinaryFormatter (Clase)

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

System.Object
  System.Runtime.Serialization.Formatters.Binary.BinaryFormatter

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

[ComVisibleAttribute(true)]
public sealed class BinaryFormatter : IRemotingFormatter, 
	IFormatter

El tipo BinaryFormatter expone los siguientes miembros.

  NombreDescripción
Método públicoBinaryFormatter()Inicializa una nueva instancia de la clase BinaryFormatter con valores predeterminados.
Método públicoBinaryFormatter(ISurrogateSelector, StreamingContext)Inicializa una nueva instancia de la clase BinaryFormatter con el selector suplente y el contexto de secuencia especificados.
Arriba

  NombreDescripción
Propiedad públicaAssemblyFormatObtiene o establece el comportamiento del deserializador en lo que respecta a buscar y cargar ensamblados.
Propiedad públicaBinderObtiene o establece un objeto de tipo SerializationBinder que controla el enlace entre un objeto serializado y un tipo.
Propiedad públicaContextObtiene o establece StreamingContext para este formateador.
Propiedad públicaFilterLevelObtiene o establece el TypeFilterLevel de la deserialización automática que realiza BinaryFormatter.
Propiedad públicaSurrogateSelectorObtiene o establece un ISurrogateSelector que controla la sustitución de tipos durante la serialización y la deserialización.
Propiedad públicaTypeFormatObtiene o establece el formato en que se distribuyen las descripciones de tipos en la secuencia serializada.
Arriba

  NombreDescripción
Método públicoDeserialize(Stream)Deserializa la secuencia especificada en un gráfico de objetos.
Método públicoDeserialize(Stream, HeaderHandler)Deserializa la secuencia especificada en un gráfico de objetos. El HeaderHandler suministrado controla los encabezados de dicha secuencia.
Método públicoDeserializeMethodResponseDeserializa una respuesta a una llamada de método remota a partir del Stream proporcionado.
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método públicoSerialize(Stream, Object)Serializa el objeto, o gráfico de objetos con el objeto superior (raíz) especificado, en la secuencia indicada.
Método públicoSerialize(Stream, Object, Header[])Serializa el objeto, o gráfico de objetos con el objeto superior (raíz) especificado, en la secuencia indicada adjuntado los encabezados proporcionados.
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoUnsafeDeserializeDeserializa la secuencia especificada en un gráfico de objetos. El HeaderHandler suministrado controla los encabezados de dicha secuencia.
Método públicoUnsafeDeserializeMethodResponseDeserializa una respuesta a una llamada de método remota a partir del Stream proporcionado.
Arriba

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).

Las llamadas RPC que utilizan BinaryFormatter se dividen en dos partes distintas: llamadas de método, que se envían al servidor con el objeto remoto que contiene el método al que se ha llamado, y respuestas de método, que se envían del servidor al cliente con la información de estado y respuesta del método al que se ha llamado.

Durante la serialización de una llamada de método, el primer objeto del gráfico de objetos debe admitir la interfaz IMethodCallMessage. Para deserializar una llamada de método, utilice el método Deserialize con el parámetro HeaderHandler. La infraestructura de comunicación remota utiliza el delegado de HeaderHandler para crear un objeto que admite la interfaz ISerializable. Cuando BinaryFormatter llama al delegado de HeaderHandler, éste devuelve la dirección URI del objeto remoto con el método al que se está llamando. El primer objeto del gráfico devuelto admite la interfaz IMethodCallMessage.

El procedimiento de serialización de una respuesta de método es idéntico al de una llamada de método, con la excepción de que el primer objeto del gráfico de objetos debe admitir la interfaz IMethodReturnMessage. Para deserializar una respuesta de método, utilice el método DeserializeMethodResponse. Para ahorrar tiempo, los detalles sobre el objeto que realiza la llamada no se envían al objeto remoto durante la llamada al método. En lugar de ello, estos detalles se obtienen de la llamada de método original, que se pasa al método DeserializeMethodResponse en el parámetro IMethodCallMessage. El primer objeto del gráfico devuelto por el método DeserializeMethodResponse admite la interfaz IMethodReturnMessage.

Suplentes sin par

Cualquier carácter suplente sin par se pierde en la serialización binaria. Por ejemplo, la cadena siguiente contiene un carácter Unicode suplente alto (\ud800) entre las dos palabras Test:

Test\ud800Test

Antes de la serialización, el byte de la matriz de la cadena es como sigue:

Valor de la matriz de bytes

Carácter

84

T

101

e

115

s

116

t

55296

\ud800

84

T

101

e

115

s

116

t

Después de la deserialización, se pierde el carácter Unicode del suplente alto:

Valor de la matriz de bytes

Carácter

84

T

101

e

115

s

116

t

84

T

101

e

115

s

116

t


using System;
using System.IO;
using System.Collections;
using System.Runtime.Serialization.Formatters.Binary;
using System.Runtime.Serialization;

public 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. 
        // In this case, use a file stream.
        FileStream fs = new FileStream("DataFile.dat", FileMode.Create);

        // Construct a BinaryFormatter and use it to serialize the data to the stream.
        BinaryFormatter formatter = new BinaryFormatter();
        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.dat", FileMode.Open);
        try 
        {
            BinaryFormatter formatter = new BinaryFormatter();

            // 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.
        foreach (DictionaryEntry de in addresses) 
        {
            Console.WriteLine("{0} lives at {1}.", de.Key, de.Value);
        }
    }
}


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft