XmlObjectSerializer Sınıf

Tanım

Ad Alanı:

System.Runtime.Serialization

Bütünleştirilmiş Kod:

System.Runtime.Serialization.dll

Nesneleri XML akışları veya belgeleri olarak serileştirmek için kullanılan temel sınıfı sağlar. Bu sınıf soyut.

public ref class XmlObjectSerializer abstract

public abstract class XmlObjectSerializer

type XmlObjectSerializer = class

Public MustInherit Class XmlObjectSerializer

Devralma

Object

XmlObjectSerializer

Türetilmiş

System.Runtime.Serialization.DataContractSerializer

System.Runtime.Serialization.Json.DataContractJsonSerializer

System.Runtime.Serialization.NetDataContractSerializer

Örnekler

Aşağıdaki örnekte parametresini içeren adlı WriteObjectWithInstance bir XmlObjectSerializer yöntem gösterilmektedir. yöntemi, yöntemini çağırarak WriteObject veya NetDataContractSerializer kullanarak DataContractSerializer bir nesneyi serileştirir.

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

Açıklamalar

XmlObjectSerializer Nesneleri seri hale getirmek ve seri durumdan çıkarmak için kendi seri hale getiricinizi oluşturmak için öğesini genişletin. DataContractSerializer hem sınıfı hem NetDataContractSerializer de sınıfı öğesinden XmlObjectSerializer devralır ve veri sözleşmesi kurallarına uyan nesneleri serileştirmek ve seri durumdan çıkarmak için kullanılır (ve DataMemberAttributekullanılarak DataContractAttribute oluşturulan nesneler).

Uygulayanlara Notlar

öğesinden XmlObjectSerializerdevraldığınızda, şu üyeleri geçersiz kılmalısınız: WriteStartObject(XmlDictionaryWriter, Object), WriteObjectContent(XmlDictionaryWriter, Object), WriteEndObject(XmlDictionaryWriter). Ayrıca okuma ve seri durumdan IsStartObject çıkarma için ve ReadObject yöntemleri uygulanmalıdır.

Oluşturucular

Name	Description
XmlObjectSerializer()	XmlObjectSerializer sınıfının yeni bir örneğini başlatır.

Yöntemler

Name	Description
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsStartObject(XmlDictionaryReader)	öğesinin okunabilen bir XML öğesinin üzerine konumlandırılıp konumlandırılmadığını XmlDictionaryReader belirten bir değer alır.
IsStartObject(XmlReader)	öğesinin okunabilen bir XML öğesinin üzerine konumlandırılıp konumlandırılmadığını XmlReader belirten bir değer alır.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ReadObject(Stream)	XML akışını veya belgesini ile Stream okur ve seri durumdan çıkarılmış nesneyi döndürür.
ReadObject(XmlDictionaryReader, Boolean)	XML akışını veya belgeyi ile XmlDictionaryReader okur ve seri durumdan çıkarılmış nesneyi döndürür; seri hale getiricinin verileri okumayı denemeden önce okuyup okuyamayacağını belirtmenizi de sağlar.
ReadObject(XmlDictionaryReader)	XML belgesini veya akışını ile XmlDictionaryReader okur ve seri durumdan çıkarılmış nesneyi döndürür.
ReadObject(XmlReader, Boolean)	XML belgesini veya akışını ile XmlReader okur ve seri durumdan çıkarılmış nesneyi döndürür; seri hale getiricinin verileri okumayı denemeden önce okuyup okuyamayacağını belirtmenizi de sağlar.
ReadObject(XmlReader)	XML belgesini veya akışını ile XmlReader okur ve seri durumdan çıkarılmış nesneyi döndürür.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
WriteEndObject(XmlDictionaryWriter)	Nesne verilerinin sonunu XML belgesine veya akışına XmlDictionaryWriterbir kapanış XML öğesi olarak yazar.
WriteEndObject(XmlWriter)	Nesne verilerinin sonunu XML belgesine veya akışına XmlWriterbir kapanış XML öğesi olarak yazar.
WriteObject(Stream, Object)	Nesnenin tam içeriğini (başlangıç, içerik ve bitiş) belirtilen Streamile XML belgesine veya akışına yazar.
WriteObject(XmlDictionaryWriter, Object)	Nesnenin tam içeriğini (başlangıç, içerik ve bitiş) belirtilen XmlDictionaryWriterile XML belgesine veya akışına yazar.
WriteObject(XmlWriter, Object)	Nesnenin tam içeriğini (başlangıç, içerik ve bitiş) belirtilen XmlWriterile XML belgesine veya akışına yazar.
WriteObjectContent(XmlDictionaryWriter, Object)	Belirtilen XmlDictionaryWriteröğesini kullanarak xml belgesine veya akışına yalnızca nesnenin içeriğini yazar.
WriteObjectContent(XmlWriter, Object)	Xml belgesine veya belirtilen XmlWriterile akışa yalnızca nesnenin içeriğini yazar.
WriteStartObject(XmlDictionaryWriter, Object)	Belirtilen XmlDictionaryWriteröğesini kullanarak nesnenin verilerinin başlangıcını bir açılış XML öğesi olarak yazar.
WriteStartObject(XmlWriter, Object)	Belirtilen XmlWriteröğesini kullanarak nesnenin verilerinin başlangıcını bir açılış XML öğesi olarak yazar.

Ayrıca bkz.

• DataContractSerializer
• NetDataContractSerializer
• Veri Sözleşmelerini Kullanma
• Veri Sözleşmesi Seri Hale Getiricisi