NetDataContractSerializer Classe

Riferimento

Definizione

Spazio dei nomi:: System.Runtime.Serialization

Assembly:: System.Runtime.Serialization.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Serializza e deserializza un'istanza di un tipo in un flusso o documento XML usando i tipi .NET Framework forniti. La classe non può essere ereditata.

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

Ereditarietà: Object

XmlObjectSerializer
NetDataContractSerializer

Implementazioni: IFormatter

Esempio

Nell'esempio di codice seguente viene illustrato un tipo denominato Person serializzato dalla classe NetDataContractSerializer. L'attributo DataContractAttribute viene applicato alla classe e l'attributo DataMemberAttribute viene applicato ai membri (inclusi membri privati) per indicare alla classe NetDataContractSerializer gli elementi da serializzare.

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

Commenti

Security

NetDataContractSerializer non è sicuro. Per altre informazioni, vedere la Guida alla sicurezza di BinaryFormatter.

Le classi NetDataContractSerializer e DataContractSerializer differiscono per un aspetto importante: la classe NetDataContractSerializer include informazioni di tipo CLR nell'XML serializzato, a differenza della classe DataContractSerializer. Pertanto, la classe NetDataContractSerializer può essere utilizzata solo se le estremità di serializzazione e deserializzazione condividono gli stessi tipi CLR.

Il serializzatore può serializzare tipi ai quali è stato applicato l'attributo DataContractAttribute o SerializableAttribute. Serializza inoltre tipi che implementano l'interfaccia ISerializable.

Per altre informazioni sulla serializzazione, vedere Serializzazione e deserializzazione.

Incompatibilità con XElement

La classe XElement viene utilizzata per la scrittura di dati XML. Tuttavia, NetDataContractSerializer non può serializzare un'istanza del tipo. Il codice seguente, pertanto, ha esito negativo con l'eccezione: "Tipo radice 'System.Xml. Linq.XElement' non è supportato al livello superiore di NetDataContractSerializer perché è IXmlSerializable con IsAny=true e deve scrivere tutto il contenuto incluso l'elemento radice."

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)

Tuttavia, se XElement viene utilizzato come tipo di un campo o di una proprietà di una classe, i dati contenuti nel campo o nella proprietà vengono serializzati. Questo avviene perché, come membri di una classe, i dati non sono il primo livello della classe.

Costruttori

NetDataContractSerializer()	Inizializza una nuova istanza della classe NetDataContractSerializer.
NetDataContractSerializer(StreamingContext)	Inizializza una nuova istanza della classe NetDataContractSerializer con i dati del contesto di flusso forniti.
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inizializza una nuova istanza della classe NetDataContractSerializer con i dati di contesto forniti; specifica inoltre il numero massimo di elementi nell'oggetto da serializzare e parametri per specificare se eventuali dati aggiuntivi vengono ignorati, il metodo di caricamento assembly e un selettore di surrogati.
NetDataContractSerializer(String, String)	Inizializza una nuova istanza della classe NetDataContractSerializer con l'elemento radice e lo spazio dei nomi XML forniti.
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inizializza una nuova istanza della classe NetDataContractSerializer con i dati di contesto forniti, il nome e lo spazio dei nomi radice; specifica inoltre il numero massimo di elementi nell'oggetto da serializzare e parametri per specificare se eventuali dati aggiuntivi vengono ignorati, il metodo di caricamento assembly e un selettore di surrogati.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	Inizializza una nuova istanza della classe NetDataContractSerializer con due parametri di tipo XmlDictionaryString che contengono l'elemento radice e lo spazio dei nomi utilizzati per specificare il contenuto.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inizializza una nuova istanza della classe NetDataContractSerializer con i dati di contesto forniti, il nome e lo spazio dei nomi radice (come parametri XmlDictionaryString); specifica inoltre il numero massimo di elementi nell'oggetto da serializzare e parametri per specificare se eventuali dati aggiuntivi vengono ignorati, il metodo di caricamento assembly e un selettore di surrogati.

Proprietà

AssemblyFormat	Ottiene un valore che specifica un metodo per l'individuazione e il caricamento di assembly.
Binder	Ottiene o imposta un oggetto che controlla il caricamento di classi.
Context	Ottiene o imposta l'oggetto che abilita il passaggio di dati di contesto utili durante la serializzazione o deserializzazione.
IgnoreExtensionDataObject	Ottiene un valore che specifica se i dati forniti da un'estensione dell'oggetto vengono ignorati.
MaxItemsInObjectGraph	Ottiene il numero massimo di elementi consentiti nell'oggetto da serializzare.
SurrogateSelector	Ottiene o imposta un oggetto che supporta il formattatore durante la selezione di un surrogato per la serializzazione.

Metodi

Deserialize(Stream)	Deserializza un documento o flusso XML in un oggetto.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsStartObject(XmlDictionaryReader)	Determina se la classe XmlDictionaryReader è posizionata su un oggetto che può essere deserializzato utilizzando un lettore specificato.
IsStartObject(XmlReader)	Determina se la classe XmlReader è posizionata su un oggetto che può essere deserializzato utilizzando un lettore specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ReadObject(Stream)	Legge il flusso o documento XML con una classe Stream e restituisce l'oggetto deserializzato. (Ereditato da XmlObjectSerializer)
ReadObject(XmlDictionaryReader)	Legge il flusso o documento XML con una classe XmlDictionaryReader e restituisce l'oggetto deserializzato. (Ereditato da XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean)	Legge il flusso o documento XML con una classe XmlDictionaryReader e restituisce l'oggetto deserializzato. Controlla inoltre se i dati dell'oggetto sono conformi al nome e allo spazio dei nomi utilizzati per creare il serializzatore.
ReadObject(XmlReader)	Legge il flusso o documento XML con una classe XmlDictionaryReader e restituisce l'oggetto deserializzato.
ReadObject(XmlReader, Boolean)	Legge il flusso o documento XML con una classe XmlDictionaryReader e restituisce l'oggetto deserializzato. Controlla inoltre se i dati dell'oggetto sono conformi al nome e allo spazio dei nomi utilizzati per creare il serializzatore.
Serialize(Stream, Object)	Serializza l'oggetto grafico specificato utilizzando il writer specificato.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
WriteEndObject(XmlDictionaryWriter)	Scrive l'elemento XML di chiusura utilizzando una classe XmlDictionaryWriter.
WriteEndObject(XmlWriter)	Scrive l'elemento XML di chiusura utilizzando una classe XmlWriter.
WriteObject(Stream, Object)	Scrive il contenuto completo (inizio, contenuto e fine) dell'oggetto nel documento XML o nel flusso con l'oggetto specificato Stream. (Ereditato da XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object)	Scrive il contenuto completo (inizio, contenuto e fine) dell'oggetto nel documento XML o nel flusso con l'oggetto specificato XmlDictionaryWriter. (Ereditato da XmlObjectSerializer)
WriteObject(XmlWriter, Object)	Scrive il contenuto completo (inizio, contenuto e fine) dell'oggetto nel documento XML o nel flusso con l'oggetto specificato XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)	Scrive il contenuto XML utilizzando un oggetto XmlDictionaryWriter.
WriteObjectContent(XmlWriter, Object)	Scrive il contenuto XML utilizzando un oggetto XmlWriter.
WriteStartObject(XmlDictionaryWriter, Object)	Scrive l'elemento XML di apertura utilizzando un oggetto XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)	Scrive l'elemento XML di apertura utilizzando un oggetto XmlWriter.

Si applica a