NetDataContractSerializer Kelas

Referensi

Definisi

Ruang nama:: System.Runtime.Serialization

Rakitan:: System.Runtime.Serialization.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menserialisasikan dan mendeserialisasi instans jenis ke aliran XML atau dokumen menggunakan jenis .NET Framework yang disediakan. Kelas ini tidak dapat diwariskan.

public ref class NetDataContractSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer, System::Runtime::Serialization::IFormatter

public sealed class NetDataContractSerializer : System.Runtime.Serialization.XmlObjectSerializer, System.Runtime.Serialization.IFormatter

type NetDataContractSerializer = class
    inherit XmlObjectSerializer
    interface IFormatter

Public NotInheritable Class NetDataContractSerializer
Inherits XmlObjectSerializer
Implements IFormatter

Warisan: Object

XmlObjectSerializer
NetDataContractSerializer

Penerapan: IFormatter

Contoh

Contoh kode berikut menunjukkan jenis bernama Person yang diserialisasikan NetDataContractSerializeroleh . Atribut DataContractAttribute diterapkan ke kelas , dan DataMemberAttribute diterapkan kepada anggota (termasuk anggota privat) untuk menginstruksikan apa yang harus diserialisasikan NetDataContractSerializer .

// You must apply a DataContractAttribute or SerializableAttribute
// to a class to have it serialized by the NetDataContractSerializer.
[DataContract(Name = "Customer", Namespace = "http://www.contoso.com")]
class Person : IExtensibleDataObject
{
    [DataMember()]
    public string FirstName;
    [DataMember]
    public string LastName;
    [DataMember()]
    public int ID;

    public Person(string newfName, string newLName, int newID)
    {
        FirstName = newfName;
        LastName = newLName;
        ID = newID;
    }

    private ExtensionDataObject extensionData_Value;

    public ExtensionDataObject ExtensionData
    {
        get
        {
            return extensionData_Value;
        }
        set
        {
            extensionData_Value = value;
        }
    }
}

public sealed class Test
{
    private Test() { }

    public static void Main()
    {
        try
        {
            WriteObject("NetDataContractSerializerExample.xml");
            ReadObject("NetDataContractSerializerExample.xml");
        }

        catch (SerializationException serExc)
        {
            Console.WriteLine("Serialization Failed");
            Console.WriteLine(serExc.Message);
        }
        catch (Exception exc)
        {
            Console.WriteLine(
            "The serialization operation failed: {0} StackTrace: {1}",
            exc.Message, exc.StackTrace);
        }

        finally
        {
            Console.WriteLine("Press <Enter> to exit....");
            Console.ReadLine();
        }
    }

    public static void WriteObject(string fileName)
    {
        Console.WriteLine(
            "Creating a Person object and serializing it.");
        Person p1 = new Person("Zighetti", "Barbara", 101);
        FileStream fs = new FileStream(fileName, FileMode.Create);
        XmlDictionaryWriter writer = XmlDictionaryWriter.CreateTextWriter(fs);
        NetDataContractSerializer ser =
            new NetDataContractSerializer();
        ser.WriteObject(writer, p1);
        writer.Close();
    }

    public static void ReadObject(string fileName)
    {
        Console.WriteLine("Deserializing an instance of the object.");
        FileStream fs = new FileStream(fileName,
        FileMode.Open);
        XmlDictionaryReader reader =
            XmlDictionaryReader.CreateTextReader(fs, new XmlDictionaryReaderQuotas());
        NetDataContractSerializer ser = new NetDataContractSerializer();

        // Deserialize the data and read it from the instance.
        Person deserializedPerson =
            (Person)ser.ReadObject(reader, true);
        fs.Close();
        Console.WriteLine(String.Format("{0} {1}, ID: {2}",
        deserializedPerson.FirstName, deserializedPerson.LastName,
        deserializedPerson.ID));
    }
}

' You must apply a DataContractAttribute or SerializableAttribute
' to a class to have it serialized by the NetDataContractSerializer.
<DataContract(Name := "Customer", [Namespace] := "http://www.contoso.com")>  _
Class Person
    Implements IExtensibleDataObject
    <DataMember()>  _
    Public FirstName As String
    <DataMember()>  _
    Public LastName As String
    <DataMember()>  _
    Public ID As Integer
    
    
    Public Sub New(ByVal newfName As String, ByVal newLName As String, _
       ByVal newID As Integer) 
        FirstName = newfName
        LastName = newLName
        ID = newID
    
    End Sub 
    
    Private extensionData_Value As ExtensionDataObject
    
    
    Public Property ExtensionData() As ExtensionDataObject _
     Implements IExtensibleDataObject.ExtensionData
        Get
            Return extensionData_Value
        End Get
        Set
            extensionData_Value = value
        End Set
    End Property
End Class 


NotInheritable Public Class Test

    Private Sub New() 
    
    End Sub
     
    Public Shared Sub Main() 
        Try
            WriteObject("NetDataContractSerializerExample.xml")
            ReadObject("NetDataContractSerializerExample.xml")
        
        Catch serExc As SerializationException
            Console.WriteLine("Serialization Failed")
            Console.WriteLine(serExc.Message)
        Catch exc As Exception
            Console.WriteLine("The serialization operation failed: {0} StackTrace: {1}", exc.Message, exc.StackTrace)
        
        Finally
            Console.WriteLine("Press <Enter> to exit....")
            Console.ReadLine()
        End Try
    
    End Sub 
    
    
    Public Shared Sub WriteObject(ByVal fileName As String) 
        Console.WriteLine("Creating a Person object and serializing it.")
        Dim p1 As New Person("Zighetti", "Barbara", 101)
        Dim fs As New FileStream(fileName, FileMode.Create)
        Dim writer As XmlDictionaryWriter = XmlDictionaryWriter.CreateTextWriter(fs)
        Dim ser As New System.Runtime.Serialization.NetDataContractSerializer()

        ser.WriteObject(writer, p1)
        writer.Close()
    
    End Sub     

    Public Shared Sub ReadObject(ByVal fileName As String) 
        Console.WriteLine("Deserializing an instance of the object.")
        Dim fs As New FileStream(fileName, FileMode.Open)
        Dim reader As XmlDictionaryReader = _
           XmlDictionaryReader.CreateTextReader(fs, New XmlDictionaryReaderQuotas())
        Dim ser As New System.Runtime.Serialization.NetDataContractSerializer()
        
        ' Deserialize the data and read it from the instance.
        Dim deserializedPerson As Person = CType(ser.ReadObject(reader, True), Person)
        fs.Close()
        Console.WriteLine(String.Format("{0} {1}, ID: {2}", deserializedPerson.FirstName, deserializedPerson.LastName, deserializedPerson.ID))
    
    End Sub 
End Class

Keterangan

Keamanan

NetDataContractSerializer tidak aman. Untuk informasi selengkapnya, lihat panduan keamanan BinaryFormatter.

Berbeda NetDataContractSerializer dari DataContractSerializer dalam satu cara penting: NetDataContractSerializer menyertakan informasi jenis CLR dalam XML berseri, sedangkan DataContractSerializer tidak. Oleh karena itu, NetDataContractSerializer dapat digunakan hanya jika ujung serialisasi dan deserialisasi berbagi jenis CLR yang sama.

Serializer dapat membuat serialisasi jenis di mana DataContractAttribute atribut atau SerializableAttribute telah diterapkan. Ini juga menserialisasikan jenis yang mengimplementasikan ISerializable.

Untuk informasi selengkapnya tentang serialisasi, lihat Serialisasi dan Deserialisasi.

Ketidaksesuaian dengan XElement

Kelas XElement ini digunakan untuk menulis XML. Namun, NetDataContractSerializer tidak dapat membuat serial instans jenis. Oleh karena itu, kode berikut gagal dengan pengecualian: "Jenis akar 'System.Xml. Linq.XElement' tidak didukung di tingkat atas oleh NetDataContractSerializer karena IXmlSerializable dengan IsAny=true dan harus menulis semua kontennya termasuk elemen root."

FileStream fs = new FileStream("mystuff.xml", FileMode.Create, FileAccess.ReadWrite);
XElement myElement = new XElement("Parent", new XElement("child1", "form"),
    new XElement("child2", "base"),
    new XElement("child3", "formbase")
    );
NetDataContractSerializer dcs = new NetDataContractSerializer();
dcs.WriteObject(fs, myElement);

Dim fs As New FileStream("mystuff.xml", FileMode.Create, FileAccess.ReadWrite)
Dim myElement As New XElement("Parent", New XElement("child1", "form"), _
    New XElement("child2", "base"), _
    New XElement("child3", "formbase") _
    )
Dim ser As New System.Runtime.Serialization. _
  NetDataContractSerializer()
ser.WriteObject(fs, myElement)

Namun, jika XElement digunakan sebagai jenis bidang atau properti kelas, data yang dimuat oleh bidang atau properti diserialisasikan. Ini karena sebagai anggota kelas, data bukan tingkat atas kelas.

Konstruktor

NetDataContractSerializer()	Menginisialisasi instans baru kelas NetDataContractSerializer.
NetDataContractSerializer(StreamingContext)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks streaming yang disediakan.
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks yang disediakan; selain itu, menentukan jumlah maksimum item dalam objek yang akan diserialisasikan, dan parameter untuk menentukan apakah data tambahan diabaikan, metode pemuatan rakitan, dan pemilih pengganti.
NetDataContractSerializer(String, String)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan elemen akar XML dan namespace yang disediakan.
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks yang disediakan dan nama akar dan namespace layanan; selain itu, menentukan jumlah maksimum item dalam objek yang akan diserialisasikan, dan parameter untuk menentukan apakah data tambahan diabaikan, metode pemuatan rakitan, dan pemilih pengganti.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan dua parameter jenis XmlDictionaryString yang berisi elemen akar dan namespace layanan yang digunakan untuk menentukan konten.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks yang disediakan, dan nama akar dan namespace layanan (sebagai XmlDictionaryString parameter); selain itu, menentukan jumlah maksimum item dalam objek yang akan diserialisasikan, dan parameter untuk menentukan apakah data tambahan yang ditemukan diabaikan, metode pemuatan rakitan, dan pemilih pengganti.

Properti

AssemblyFormat	Mendapatkan nilai yang menentukan metode untuk menemukan dan memuat rakitan.
Binder	Mendapatkan atau mengatur objek yang mengontrol pemuatan kelas.
Context	Mendapatkan atau mengatur objek yang memungkinkan pengeluaran data konteks yang berguna saat membuat serialisasi atau deserialisasi.
IgnoreExtensionDataObject	Mendapatkan nilai yang menentukan apakah data yang disediakan oleh ekstensi objek diabaikan.
MaxItemsInObjectGraph	Mendapatkan jumlah maksimum item yang diizinkan dalam objek untuk diserialisasikan.
SurrogateSelector	Mendapatkan atau mengatur objek yang membantu pemformat saat memilih pengganti untuk serialisasi.

Metode

Deserialize(Stream)	Mendeserialisasi dokumen XML atau mengalirkan ke objek.
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 instans Type saat ini. (Diperoleh dari Object)
IsStartObject(XmlDictionaryReader)	Menentukan apakah XmlDictionaryReader diposisikan pada objek yang dapat dideserialisasi menggunakan pembaca yang ditentukan.
IsStartObject(XmlReader)	Menentukan apakah XmlReader diposisikan pada objek yang dapat dideserialisasi menggunakan pembaca yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ReadObject(Stream)	Membaca aliran atau dokumen XML dengan Stream dan mengembalikan objek yang dideserialisasi. (Diperoleh dari XmlObjectSerializer)
ReadObject(XmlDictionaryReader)	Membaca dokumen XML atau streaming dengan XmlDictionaryReader dan mengembalikan objek yang dideserialisasi. (Diperoleh dari XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean)	Membaca aliran atau dokumen XML dengan dan mengembalikan objek yang dideserialisasi; juga memeriksa apakah data objek sesuai dengan XmlDictionaryReader nama dan namespace yang digunakan untuk membuat serializer.
ReadObject(XmlReader)	Membaca aliran xml atau dokumen dengan XmlDictionaryReader dan mengembalikan objek yang dideserialisasi.
ReadObject(XmlReader, Boolean)	Membaca aliran atau dokumen XML dengan dan mengembalikan objek yang dideserialisasi; juga memeriksa apakah data objek sesuai dengan XmlDictionaryReader nama dan namespace yang digunakan untuk membuat serializer.
Serialize(Stream, Object)	Membuat serialisasi grafik objek yang ditentukan menggunakan penulis yang ditentukan.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
WriteEndObject(XmlDictionaryWriter)	Menulis elemen XML penutup menggunakan XmlDictionaryWriter.
WriteEndObject(XmlWriter)	Menulis elemen XML penutup menggunakan XmlWriter.
WriteObject(Stream, Object)	Menulis konten lengkap (mulai, konten, dan akhir) objek ke dokumen XML atau streaming dengan yang ditentukan Stream. (Diperoleh dari XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object)	Menulis konten lengkap (mulai, konten, dan akhir) objek ke dokumen XML atau streaming dengan yang ditentukan XmlDictionaryWriter. (Diperoleh dari XmlObjectSerializer)
WriteObject(XmlWriter, Object)	Menulis konten lengkap (mulai, konten, dan akhir) objek ke dokumen XML atau streaming dengan yang ditentukan XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)	Menulis konten XML menggunakan XmlDictionaryWriter.
WriteObjectContent(XmlWriter, Object)	Menulis konten XML menggunakan XmlWriter.
WriteStartObject(XmlDictionaryWriter, Object)	Menulis elemen XML pembuka menggunakan XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)	Menulis elemen XML pembuka menggunakan XmlWriter.

Berlaku untuk

Bagikan melalui