XmlObjectSerializer Kelas

Definisi

Ruang nama:

System.Runtime.Serialization

Rakitan:

System.Runtime.Serialization.dll

Menyediakan kelas dasar yang digunakan untuk menserialisasikan objek sebagai aliran atau dokumen XML. Kelas ini abstrak.

public ref class XmlObjectSerializer abstract

public abstract class XmlObjectSerializer

type XmlObjectSerializer = class

Public MustInherit Class XmlObjectSerializer

Warisan

Object

XmlObjectSerializer

Turunan

System.Runtime.Serialization.DataContractSerializer

System.Runtime.Serialization.Json.DataContractJsonSerializer

System.Runtime.Serialization.NetDataContractSerializer

Contoh

Contoh berikut menunjukkan metode bernama WriteObjectWithInstance yang menyertakan XmlObjectSerializer sebagai parameter. Metode ini menserialisasikan objek menggunakan DataContractSerializer atau NetDataContractSerializer dengan memanggil WriteObject metode .

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

Keterangan

XmlObjectSerializer Perluas untuk membuat serializer Anda sendiri untuk membuat serialisasi dan mendeserialisasi objek. DataContractSerializer Baik kelas maupun NetDataContractSerializer kelas mewarisi dari XmlObjectSerializer dan digunakan untuk menserialisasikan dan mendeserialisasi objek yang sesuai dengan aturan kontrak data (objek yang dibuat menggunakan DataContractAttribute dan DataMemberAttribute).

Catatan Bagi Implementer

Ketika Anda mewarisi dari XmlObjectSerializer, Anda harus mengambil alih anggota berikut: WriteStartObject(XmlDictionaryWriter, Object), , WriteObjectContent(XmlDictionaryWriter, Object)WriteEndObject(XmlDictionaryWriter). Selain itu, IsStartObject metode dan ReadObject harus diimplementasikan untuk membaca dan mendeserialisasi.

Konstruktor

Nama	Deskripsi
XmlObjectSerializer()	Menginisialisasi instans baru dari kelas XmlObjectSerializer.

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
IsStartObject(XmlDictionaryReader)	Mendapatkan nilai yang menentukan apakah XmlDictionaryReader diposisikan di atas elemen XML yang dapat dibaca.
IsStartObject(XmlReader)	Mendapatkan nilai yang menentukan apakah XmlReader diposisikan di atas elemen XML yang dapat dibaca.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ReadObject(Stream)	Membaca aliran XML atau dokumen dengan Stream dan mengembalikan objek yang dideserialisasi.
ReadObject(XmlDictionaryReader, Boolean)	Membaca aliran XML atau dokumen dengan XmlDictionaryReader dan mengembalikan objek yang dideserialisasi; ini juga memungkinkan Anda menentukan apakah serializer dapat membaca data sebelum mencoba membacanya.
ReadObject(XmlDictionaryReader)	Membaca dokumen XML atau streaming dengan XmlDictionaryReader dan mengembalikan objek yang dideserialisasi.
ReadObject(XmlReader, Boolean)	Membaca dokumen XML atau streaming dengan XmlReader dan mengembalikan objek yang dideserialisasi; ini juga memungkinkan Anda menentukan apakah serializer dapat membaca data sebelum mencoba membacanya.
ReadObject(XmlReader)	Membaca dokumen XML atau streaming dengan XmlReader dan mengembalikan objek yang dideserialisasi.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
WriteEndObject(XmlDictionaryWriter)	Menulis akhir data objek sebagai elemen XML penutup ke dokumen XML atau streaming dengan XmlDictionaryWriter.
WriteEndObject(XmlWriter)	Menulis akhir data objek sebagai elemen XML penutup ke dokumen XML atau streaming dengan XmlWriter.
WriteObject(Stream, Object)	Menulis konten lengkap (mulai, konten, dan akhir) objek ke dokumen XML atau streaming dengan yang ditentukan Stream.
WriteObject(XmlDictionaryWriter, Object)	Menulis konten lengkap (mulai, konten, dan akhir) objek ke dokumen XML atau streaming dengan yang ditentukan XmlDictionaryWriter.
WriteObject(XmlWriter, Object)	Menulis konten lengkap (mulai, konten, dan akhir) objek ke dokumen XML atau streaming dengan yang ditentukan XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)	Hanya menulis konten objek ke dokumen XML atau streaming menggunakan XmlDictionaryWriter.
WriteObjectContent(XmlWriter, Object)	Hanya menulis konten objek ke dokumen XML atau streaming dengan yang ditentukan XmlWriter.
WriteStartObject(XmlDictionaryWriter, Object)	Menulis awal data objek sebagai elemen XML pembuka menggunakan yang ditentukan XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)	Menulis awal data objek sebagai elemen XML pembuka menggunakan yang ditentukan XmlWriter.

Lihat juga

• DataContractSerializer
• NetDataContractSerializer
• Menggunakan Kontrak Data
• Serializer Kontrak Data