XmlObjectSerializer Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona la clase base que se usa para serializar objetos como flujos XML o documentos. Esta clase es abstracta.
public ref class XmlObjectSerializer abstract
public abstract class XmlObjectSerializer
type XmlObjectSerializer = class
Public MustInherit Class XmlObjectSerializer
- Herencia
-
XmlObjectSerializer
- Derivado
Ejemplos
En el ejemplo siguiente se muestra un método denominado WriteObjectWithInstance que incluye como XmlObjectSerializer parámetro . El método serializa un objeto mediante o DataContractSerializerNetDataContractSerializer llamando al WriteObject método .
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();
}
}
Public Class Test
Private Sub WriteObjectWithInstance(ByVal xm As XmlObjectSerializer, _
ByVal graph As Company, ByVal fileName As String)
' Use either the XmlDataContractSerializer or NetDataContractSerializer,
' or any other class that inherits from XmlObjectSerializer to write with.
Console.WriteLine(xm.GetType())
Dim fs As New FileStream(fileName, FileMode.Create)
Dim writer As XmlDictionaryWriter = XmlDictionaryWriter.CreateTextWriter(fs)
xm.WriteObject(writer, graph)
Console.WriteLine("Done writing {0}", fileName)
End Sub
Private Sub Run()
' Create the object to write to a file.
Dim graph As New Company()
graph.Name = "cohowinery.com"
' Create a DataContractSerializer and a NetDataContractSerializer.
' Pass either one to the WriteObjectWithInstance method.
Dim dcs As New DataContractSerializer(GetType(Company))
Dim ndcs As New NetDataContractSerializer()
WriteObjectWithInstance(dcs, graph, "datacontract.xml")
WriteObjectWithInstance(ndcs, graph, "netDatacontract.xml")
End Sub
<DataContract()> _
Public Class Company
<DataMember()> _
Public Name As String
End Class
Shared Sub Main()
Try
Console.WriteLine("Starting")
Dim t As New Test()
t.Run()
Console.WriteLine("Done")
Console.ReadLine()
Catch iExc As InvalidDataContractException
Console.WriteLine("You have an invalid data contract: ")
Console.WriteLine(iExc.Message)
Console.ReadLine()
Catch serExc As SerializationException
Console.WriteLine("There is a problem with the instance:")
Console.WriteLine(serExc.Message)
Console.ReadLine()
Catch qExc As QuotaExceededException
Console.WriteLine("The quota has been exceeded")
Console.WriteLine(qExc.Message)
Console.ReadLine()
Catch exc As Exception
Console.WriteLine(exc.Message)
Console.WriteLine(exc.ToString())
Console.ReadLine()
End Try
End Sub
End Class
Comentarios
XmlObjectSerializer Amplíe para crear su propio serializador para serializar y deserializar objetos. Tanto la DataContractSerializer clase como la NetDataContractSerializer clase heredan de XmlObjectSerializer y se usan para serializar y deserializar objetos que se ajustan a las reglas de contrato de datos (objetos creados mediante DataContractAttribute y DataMemberAttribute).
Notas a los implementadores
Al heredar de XmlObjectSerializer, debe invalidar los siguientes miembros: WriteStartObject(XmlDictionaryWriter, Object), WriteObjectContent(XmlDictionaryWriter, Object), WriteEndObject(XmlDictionaryWriter). Además, los IsStartObject métodos y ReadObject se deben implementar para leer y deserializar.
Constructores
| Nombre | Description |
|---|---|
| XmlObjectSerializer() |
Inicializa una nueva instancia de la clase XmlObjectSerializer. |
Métodos
| Nombre | Description |
|---|---|
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| IsStartObject(XmlDictionaryReader) |
Obtiene un valor que especifica si XmlDictionaryReader se coloca sobre un elemento XML que se puede leer. |
| IsStartObject(XmlReader) |
Obtiene un valor que especifica si XmlReader se coloca sobre un elemento XML que se puede leer. |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| ReadObject(Stream) |
Lee la secuencia XML o el documento con y Stream devuelve el objeto deserializado. |
| ReadObject(XmlDictionaryReader, Boolean) |
Lee la secuencia XML o el documento con XmlDictionaryReader y devuelve el objeto deserializado; también permite especificar si el serializador puede leer los datos antes de intentar leerlos. |
| ReadObject(XmlDictionaryReader) |
Lee el documento o secuencia XML con y XmlDictionaryReader devuelve el objeto deserializado. |
| ReadObject(XmlReader, Boolean) |
Lee el documento XML o secuencia con XmlReader y devuelve el objeto deserializado; también le permite especificar si el serializador puede leer los datos antes de intentar leerlos. |
| ReadObject(XmlReader) |
Lee el documento o secuencia XML con y XmlReader devuelve el objeto deserializado. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| WriteEndObject(XmlDictionaryWriter) |
Escribe el final de los datos del objeto como un elemento XML de cierre en el documento XML o secuencia con un XmlDictionaryWriter. |
| WriteEndObject(XmlWriter) |
Escribe el final de los datos del objeto como un elemento XML de cierre en el documento XML o secuencia con un XmlWriter. |
| WriteObject(Stream, Object) |
Escribe el contenido completo (inicio, contenido y fin) del objeto en el documento XML o secuencia con el especificado Stream. |
| WriteObject(XmlDictionaryWriter, Object) |
Escribe el contenido completo (inicio, contenido y fin) del objeto en el documento XML o secuencia con el especificado XmlDictionaryWriter. |
| WriteObject(XmlWriter, Object) |
Escribe el contenido completo (inicio, contenido y fin) del objeto en el documento XML o secuencia con el especificado XmlWriter. |
| WriteObjectContent(XmlDictionaryWriter, Object) |
Escribe solo el contenido del objeto en el documento XML o secuencia mediante el especificado XmlDictionaryWriter. |
| WriteObjectContent(XmlWriter, Object) |
Escribe solo el contenido del objeto en el documento XML o secuencia con el especificado XmlWriter. |
| WriteStartObject(XmlDictionaryWriter, Object) |
Escribe el inicio de los datos del objeto como un elemento XML de apertura mediante el especificado XmlDictionaryWriter. |
| WriteStartObject(XmlWriter, Object) |
Escribe el inicio de los datos del objeto como un elemento XML de apertura mediante el especificado XmlWriter. |