Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase XmlObjectSerializer

 

Publicado: octubre de 2016

Proporciona la clase base usada para serializar objetos como secuencias XML o documentos. Esta clase es abstracta.

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


public abstract class XmlObjectSerializer

NombreDescripción
System_CAPS_protmethodXmlObjectSerializer()

Inicializa una nueva instancia de la clase XmlObjectSerializer.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsStartObject(XmlDictionaryReader)

Obtiene un valor que especifica si XmlDictionaryReader se coloca sobre un elemento XML que se puede leer.

System_CAPS_pubmethodIsStartObject(XmlReader)

Obtiene un valor que especifica si XmlReader se coloca sobre un elemento XML que se puede leer.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodReadObject(Stream)

Lee la secuencia o el documento XML con Stream y devuelve el objeto deserializado.

System_CAPS_pubmethodReadObject(XmlDictionaryReader)

Lee el documento o la secuencia XML con XmlDictionaryReader y devuelve el objeto deserializado.

System_CAPS_pubmethodReadObject(XmlDictionaryReader, Boolean)

Lee la secuencia o el documento XML con XmlDictionaryReader y devuelve el objeto deserializado; también le permite especificar si el serializador puede leer los datos antes de intentar leerlos.

System_CAPS_pubmethodReadObject(XmlReader)

Lee el documento o la secuencia XML con XmlReader y devuelve el objeto deserializado.

System_CAPS_pubmethodReadObject(XmlReader, Boolean)

Lee el documento o la secuencia XML con XmlReader y devuelve el objeto deserializado; también le permite especificar si el serializador puede leer los datos antes de intentar leerlos.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_pubmethodWriteEndObject(XmlDictionaryWriter)

Escribe el fin de los datos de objeto como un elemento XML de cierre en el documento o la secuencia XML con XmlDictionaryWriter.

System_CAPS_pubmethodWriteEndObject(XmlWriter)

Escribe el fin de los datos de objeto como un elemento XML de cierre en el documento o la secuencia XML con XmlWriter.

System_CAPS_pubmethodWriteObject(Stream, Object)

Escribe todo el contenido (inicio, contenido y fin) del objeto en el documento o la secuencia XML con el Stream especificado.

System_CAPS_pubmethodWriteObject(XmlDictionaryWriter, Object)

Escribe todo el contenido (inicio, contenido y fin) del objeto en el documento o la secuencia XML con el XmlDictionaryWriter especificado.

System_CAPS_pubmethodWriteObject(XmlWriter, Object)

Escribe todo el contenido (inicio, contenido y fin) del objeto en el documento o la secuencia XML con el XmlWriter especificado.

System_CAPS_pubmethodWriteObjectContent(XmlDictionaryWriter, Object)

Escribe sólo el contenido del objeto en el documento o la secuencia XML con el XmlDictionaryWriter especificado.

System_CAPS_pubmethodWriteObjectContent(XmlWriter, Object)

Escribe sólo el contenido del objeto en el documento o la secuencia XML con el XmlWriter especificado.

System_CAPS_pubmethodWriteStartObject(XmlDictionaryWriter, Object)

Escribe el inicio de los datos del objeto como elemento XML de apertura con el XmlDictionaryWriter especificado.

System_CAPS_pubmethodWriteStartObject(XmlWriter, Object)

Escribe el inicio de los datos del objeto como elemento XML de apertura con el XmlWriter especificado.

Exception Condition
InvalidDataContractException

el tipo que se está serializando no se ajusta a las reglas del contrato de datos. Por ejemplo, el atributo DataContractAttribute no se ha aplicado al tipo.

SerializationException

hay un problema con la instancia que se está serializando.

Extienda XmlObjectSerializer para crear su propio serializador a fin de serializar y deserializar objetos. La clase DataContractSerializer y la clase NetDataContractSerializer se heredan de XmlObjectSerializer y se usan para serializar y deserializar objetos que se ajustan a las reglas del contrato de datos (objetos creados con DataContractAttribute y DataMemberAttribute).

Notas para desarrolladores de herederos:

Al heredar de XmlObjectSerializer, es necesario invalidar los miembros siguientes: XmlObjectSerializer.WriteStartObject(XmlDictionaryWriter, Object), XmlObjectSerializer.WriteObjectContent(XmlDictionaryWriter, Object), XmlObjectSerializer.WriteEndObject(XmlDictionaryWriter). Además, deben implementarse los métodos IsStartObject y ReadObject para leer y serializar.

El ejemplo siguiente muestra un método denominado WriteObjectWithInstance que incluye un XmlObjectSerializer como parámetro. El método serializa un objeto con DataContractSerializer o NetDataContractSerializer llamando al método WriteObject.

public class Test
{
    private void WriteObjectWithInstance(XmlObjectSerializer xm, Company graph,
       string fileName)
    {
        // Use either the XmlDataContractSerializer or NetDataContractSerializer,
        // or any other class that inherits from XmlObjectSerializer to write with.
        Console.WriteLine(xm.GetType());
        FileStream fs = new FileStream(fileName, FileMode.Create);
        XmlDictionaryWriter writer = XmlDictionaryWriter.CreateTextWriter(fs);
        xm.WriteObject(writer, graph);
        Console.WriteLine("Done writing {0}", fileName);
    }

    private void Run()
    {
        // Create the object to write to a file.
        Company graph = new Company();
        graph.Name = "cohowinery.com";

        // Create a DataContractSerializer and a NetDataContractSerializer.
        // Pass either one to the WriteObjectWithInstance method.
        DataContractSerializer dcs = new DataContractSerializer(typeof(Company));
        NetDataContractSerializer ndcs = new NetDataContractSerializer();
        WriteObjectWithInstance(dcs, graph, @"datacontract.xml");
        WriteObjectWithInstance(ndcs, graph, @"netDatacontract.xml");
    }

    [DataContract]
    public class Company
    {
        [DataMember]
        public string Name;
    }

    static void Main()
    {
        try
        {
            Console.WriteLine("Starting");
            Test t = new Test();
            t.Run();
            Console.WriteLine("Done");
            Console.ReadLine();
        }

        catch (InvalidDataContractException iExc)
        {
            Console.WriteLine("You have an invalid data contract: ");
            Console.WriteLine(iExc.Message);
            Console.ReadLine();
        }

        catch (SerializationException serExc)
        {
            Console.WriteLine("There is a problem with the instance:");
            Console.WriteLine(serExc.Message);
            Console.ReadLine();
        }

        catch (QuotaExceededException qExc)
        {
            Console.WriteLine("The quota has been exceeded");
            Console.WriteLine(qExc.Message);
            Console.ReadLine();
        }
        catch (Exception exc)
        {
            Console.WriteLine(exc.Message);
            Console.WriteLine(exc.ToString());
            Console.ReadLine();
        }
    }

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 3.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: