NetDataContractSerializer Sınıf

Başvuru

Tanım

Ad Alanı:: System.Runtime.Serialization

Bütünleştirilmiş Kod:: System.Runtime.Serialization.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Sağlanan .NET Framework türlerini kullanarak bir türün örneğini XML akışında veya belgesinde seri durumdan çıkarma ve seri durumdan çıkarma. Bu sınıf devralınamaz.

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

Devralma: Object

XmlObjectSerializer
NetDataContractSerializer

Uygulamalar: IFormatter

Örnekler

Aşağıdaki örnek kod, tarafından NetDataContractSerializerserileştirilmiş adlı Person bir türü gösterir. DataContractAttribute özniteliği sınıfına uygulanır ve DataMemberAttribute nelerin seri hale getirilip seri hale getirilemeyebilirim yönergesi NetDataContractSerializer vermek için üyelere (özel üye dahil) uygulanır.

// 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

Açıklamalar

Güvenlik

NetDataContractSerializer güvenli değildir. Daha fazla bilgi için bkz. BinaryFormatter güvenlik kılavuzu.

şunlardan NetDataContractSerializer DataContractSerializer farklıdır: NetDataContractSerializer serileştirilmiş XML'de CLR tür bilgilerini içerirken DataContractSerializer , öğesini içermez. Bu nedenle, NetDataContractSerializer yalnızca hem seri hale getirme hem de seri durumdan çıkarma uçları aynı CLR türlerini paylaşıyorsa kullanılabilir.

Seri hale getirici, veya SerializableAttribute özniteliğinin DataContractAttribute uygulandığı türleri seri hale getirebilir. Ayrıca uygulayan ISerializabletürleri serileştirir.

Serileştirme hakkında daha fazla bilgi için bkz . Serileştirme ve Seri Durumdan Çıkarma.

XElement ile uyumsuzluk

XElement sınıfı XML yazmak için kullanılır. Ancak, NetDataContractSerializer türün bir örneğini seri hale getiremez. Bu nedenle aşağıdaki kod şu özel durumla başarısız olur: "Kök türü 'System.Xml. Ile IXmlSerializable IsAny=true olduğundan ve kök öğesi de dahil olmak üzere tüm içeriğini yazması gerektiğinden, Linq.XElement' NetDataContractSerializer tarafından en üst düzeyde desteklenmez."

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)

Ancak, bir XElement sınıfın alan veya özellik türü olarak kullanılırsa, alan veya özellik tarafından bulunan veriler seri hale getirilir. Bunun nedeni, bir sınıfın üyesi olarak verilerin sınıfın en üst düzeyi olmamasıdır.

Oluşturucular

NetDataContractSerializer()	NetDataContractSerializer sınıfının yeni bir örneğini başlatır.
NetDataContractSerializer(StreamingContext)	Sağlanan akış bağlam verileriyle sınıfının yeni bir örneğini NetDataContractSerializer başlatır.
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Sağlanan bağlam verileriyle sınıfının yeni bir örneğini NetDataContractSerializer başlatır; buna ek olarak, serileştirilecek nesnedeki en fazla öğe sayısını ve ek verilerin yoksayılıp yoksayılmayacağını belirtmek için parametreleri, derleme yükleme yöntemini ve vekil seçiciyi belirtir.
NetDataContractSerializer(String, String)	Sağlanan XML kök öğesi ve ad alanı ile sınıfının yeni bir örneğini NetDataContractSerializer başlatır.
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Sağlanan bağlam verileri ve kök adı ve ad alanı ile sınıfının yeni bir örneğini NetDataContractSerializer başlatır; ayrıca, serileştirilecek nesnedeki en fazla öğe sayısını ve ek verilerin yoksayılıp yoksayılmayacağını belirtmek için parametreleri, derleme yükleme yöntemini ve vekil seçiciyi belirtir.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	İçeriği belirtmek için kullanılan kök öğeyi NetDataContractSerializer ve ad alanını içeren türünde XmlDictionaryString iki parametre ile sınıfının yeni bir örneğini başlatır.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Sağlanan bağlam verileri ve kök adı ve ad alanı (parametre olarakXmlDictionaryString) ile sınıfın NetDataContractSerializer yeni bir örneğini başlatır; ayrıca, serileştirilecek nesnedeki en fazla öğe sayısını ve bulunan ek verilerin yoksayılıp yoksayılmayacağını belirtmek için parametreleri, derleme yükleme yöntemini ve vekil seçiciyi belirtir.

Özellikler

AssemblyFormat	Derlemeleri bulmak ve yüklemek için bir yöntem belirten bir değer alır.
Binder	Sınıf yüklemesini denetleen bir nesneyi alır veya ayarlar.
Context	Seri hale getirme veya seri durumdan çıkarma sırasında yararlı olan bağlam verilerinin geçirilmesini sağlayan nesneyi alır veya ayarlar.
IgnoreExtensionDataObject	Nesnenin bir uzantısı tarafından sağlanan verilerin yoksayılıp yoksayılmayacağını belirten bir değer alır.
MaxItemsInObjectGraph	Nesnede seri hale getirilecek en fazla öğe sayısını alır.
SurrogateSelector	Serileştirme için bir vekil seçerken biçimlendiriciye yardımcı olan bir nesneyi alır veya ayarlar.

Yöntemler

Deserialize(Stream)	XML belgesinin veya akışının seri durumdan çıkararak bir nesneye akışını sağlar.
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()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsStartObject(XmlDictionaryReader)	öğesinin XmlDictionaryReader , belirtilen okuyucu kullanılarak seri durumdan çıkarılabilen bir nesneye yerleştirilip yerleştirilmeyeceğini belirler.
IsStartObject(XmlReader)	öğesinin XmlReader , belirtilen okuyucu kullanılarak seri durumdan çıkarılabilen bir nesneye yerleştirilip yerleştirilmeyeceğini belirler.
MemberwiseClone()	Geçerli Objectöğesinin sığ 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. (Devralındığı yer: XmlObjectSerializer)
ReadObject(XmlDictionaryReader)	XML belgesini veya akışını bir XmlDictionaryReader ile okur ve seri durumdan çıkarılmış nesneyi döndürür. (Devralındığı yer: XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean)	XML akışını veya belgesini bir XmlDictionaryReader ile okur ve seri durumdan çıkarılmış nesneyi döndürür; ayrıca nesne verilerinin seri hale getiriciyi oluşturmak için kullanılan ad alanına ve ad alanına uygun olup olmadığını denetler.
ReadObject(XmlReader)	XML akışını veya belgesini bir XmlDictionaryReader ile okur ve seri durumdan çıkarılmış nesneyi döndürür.
ReadObject(XmlReader, Boolean)	XML akışını veya belgesini bir XmlDictionaryReader ile okur ve seri durumdan çıkarılmış nesneyi döndürür; ayrıca nesne verilerinin seri hale getiriciyi oluşturmak için kullanılan ad alanına ve ad alanına uygun olup olmadığını denetler.
Serialize(Stream, Object)	Belirtilen yazıcıyı kullanarak belirtilen nesne grafını serileştirir.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
WriteEndObject(XmlDictionaryWriter)	kapanış XML öğesini kullanarak XmlDictionaryWriteryazar.
WriteEndObject(XmlWriter)	kapanış XML öğesini kullanarak XmlWriteryazar.
WriteObject(Stream, Object)	Nesnenin tam içeriğini (başlangıç, içerik ve bitiş) belirtilen Streamile XML belgesine veya akışına yazar. (Devralındığı yer: XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object)	Nesnenin tam içeriğini (başlangıç, içerik ve bitiş) belirtilen XmlDictionaryWriterile XML belgesine veya akışına yazar. (Devralındığı yer: XmlObjectSerializer)
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)	XML içeriğini kullanarak XmlDictionaryWriteryazar.
WriteObjectContent(XmlWriter, Object)	XML içeriğini kullanarak XmlWriteryazar.
WriteStartObject(XmlDictionaryWriter, Object)	açılış XML öğesini kullanarak XmlDictionaryWriteryazar.
WriteStartObject(XmlWriter, Object)	açılış XML öğesini kullanarak XmlWriteryazar.

Şunlara uygulanır

Aracılığıyla paylaş