NetDataContractSerializer Costruttori

Definizione

Inizializza una nuova istanza della classe NetDataContractSerializer.

Overload

Nome Descrizione
NetDataContractSerializer()

Inizializza una nuova istanza della classe NetDataContractSerializer.

NetDataContractSerializer(StreamingContext)

Inizializza una nuova istanza della NetDataContractSerializer classe con i dati del contesto di streaming forniti.

NetDataContractSerializer(String, String)

Inizializza una nuova istanza della NetDataContractSerializer classe con l'elemento radice e lo spazio dei nomi XML forniti.

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Inizializza una nuova istanza della NetDataContractSerializer classe con due parametri di tipo XmlDictionaryString che contengono l'elemento radice e lo spazio dei nomi usati per specificare il contenuto.

NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Inizializza una nuova istanza della NetDataContractSerializer classe con i dati di contesto forniti. Specifica inoltre il numero massimo di elementi nell'oggetto da serializzare e i parametri per specificare se i dati aggiuntivi vengono ignorati, il metodo di caricamento dell'assembly e un selettore surrogato.

NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Inizializza una nuova istanza della NetDataContractSerializer classe con i dati di contesto forniti e il nome radice e lo spazio dei nomi. Specifica inoltre il numero massimo di elementi nell'oggetto da serializzare e i parametri per specificare se i dati aggiuntivi vengono ignorati, il metodo di caricamento dell'assembly e un selettore surrogato.

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Inizializza una nuova istanza della NetDataContractSerializer classe con i dati di contesto forniti e il nome radice e lo spazio dei nomi (come XmlDictionaryString parametri); specifica inoltre il numero massimo di elementi nell'oggetto da serializzare e i parametri per specificare se i dati aggiuntivi trovati vengono ignorati, il metodo di caricamento dell'assembly e un selettore surrogato.

NetDataContractSerializer()

Inizializza una nuova istanza della classe NetDataContractSerializer.

public:
 NetDataContractSerializer();
public NetDataContractSerializer();
Public Sub New ()

Esempio

public static void Constructor1()
{
    // Create an instance of the NetDataContractSerializer.
    NetDataContractSerializer ser =
        new NetDataContractSerializer();
    // Other code not shown.
}
Public Shared Sub Constructor1() 
    ' Create an instance of the NetDataContractSerializer.
    Dim ser As New System.Runtime.Serialization.NetDataContractSerializer()

End Sub 

' Other code not shown.

Si applica a

NetDataContractSerializer(StreamingContext)

Inizializza una nuova istanza della NetDataContractSerializer classe con i dati del contesto di streaming forniti.

public:
 NetDataContractSerializer(System::Runtime::Serialization::StreamingContext context);
public NetDataContractSerializer(System.Runtime.Serialization.StreamingContext context);
new System.Runtime.Serialization.NetDataContractSerializer : System.Runtime.Serialization.StreamingContext -> System.Runtime.Serialization.NetDataContractSerializer
Public Sub New (context As StreamingContext)

Parametri

context
StreamingContext

Oggetto StreamingContext contenente i dati di contesto.

Esempio

Nell'esempio seguente viene creata un'istanza NetDataContractSerializer di utilizzando un oggetto StreamingContext.

public static void Constructor2()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);
    // Create a DatatContractSerializer with the collection.
    NetDataContractSerializer ser2 = new NetDataContractSerializer(sc);

    // Other code not shown.
}
Public Shared Sub Constructor2() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    ' Create a DatatContractSerializer with the collection.
    Dim ser2 As New System.Runtime.Serialization.NetDataContractSerializer(sc)

   ' Other code not shown.
End Sub

Commenti

La StreamingContext classe consente di passare dati di contesto specifici dell'utente da usare durante la lettura e la scrittura di oggetti.

Si applica a

NetDataContractSerializer(String, String)

Inizializza una nuova istanza della NetDataContractSerializer classe con l'elemento radice e lo spazio dei nomi XML forniti.

public:
 NetDataContractSerializer(System::String ^ rootName, System::String ^ rootNamespace);
public NetDataContractSerializer(string rootName, string rootNamespace);
new System.Runtime.Serialization.NetDataContractSerializer : string * string -> System.Runtime.Serialization.NetDataContractSerializer
Public Sub New (rootName As String, rootNamespace As String)

Parametri

rootName
String

Nome dell'elemento XML che racchiude il contenuto da serializzare o deserializzare.

rootNamespace
String

Spazio dei nomi dell'elemento XML che racchiude il contenuto da serializzare o deserializzare.

Esempio

Nell'esempio seguente viene creata un'istanza dell'elemento DataContractSerializer radice XML e dello spazio dei nomi previsto durante la deserializzazione di un oggetto.

public static void Constructor3()
{
    // Create an instance of the NetDataContractSerializer
    // specifying the name and namespace as strings.
    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        "Customer",
        "http://www.contoso.com");
    // Other code not shown.
}
Public Shared Sub Constructor3() 
    ' Create an instance of the NetDataContractSerializer
    ' specifying the name and namespace as strings.
    Dim ser As New System.Runtime.Serialization. _
       NetDataContractSerializer("Customer", "http://www.contoso.com")

   ' Other code not shown.

End Sub

Si applica a

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Inizializza una nuova istanza della NetDataContractSerializer classe con due parametri di tipo XmlDictionaryString che contengono l'elemento radice e lo spazio dei nomi usati per specificare il contenuto.

public:
 NetDataContractSerializer(System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace);
public NetDataContractSerializer(System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace);
new System.Runtime.Serialization.NetDataContractSerializer : System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString -> System.Runtime.Serialization.NetDataContractSerializer
Public Sub New (rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString)

Parametri

rootName
XmlDictionaryString

Oggetto XmlDictionaryString contenente il nome dell'elemento XML che racchiude il contenuto da serializzare o deserializzare.

rootNamespace
XmlDictionaryString

Oggetto XmlDictionaryString contenente lo spazio dei nomi dell'elemento XML che racchiude il contenuto da serializzare o deserializzare.

Esempio

Nell'esempio seguente viene creata un'istanza dell'elemento DataContractSerializer radice XML e dello spazio dei nomi (come XmlDictionaryString argomenti) prevista durante la deserializzazione di un oggetto.

public static void Constructor4()
{
    // Create an XmlDictionary and add values to it.
    XmlDictionary d = new XmlDictionary();
    // Initialize the out variables.
    XmlDictionaryString name_value = d.Add("Customer");
    XmlDictionaryString ns_value = d.Add("http://www.contoso.com");

    // Create the serializer.
    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        name_value,
        ns_value);
    // Other code not shown.
}
 Public Shared Sub Constructor4() 
     ' Create an XmlDictionary and add values to it.
     Dim d As New XmlDictionary()
     Dim name_value As XmlDictionaryString =d.Add("Customer")
     Dim ns_value As XmlDictionaryString = d.Add("http://www.contoso.com")
     
     ' Create the serializer.
     Dim ser As New System.Runtime.Serialization. _
        NetDataContractSerializer(name_value, ns_value)

     ' Other code not shown.
 
 End Sub

Commenti

XmlDictionaryString Può essere usato per ottimizzare le prestazioni quando lo stesso set di stringhe viene usato tra le istanze dell'oggetto.

Si applica a

NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Inizializza una nuova istanza della NetDataContractSerializer classe con i dati di contesto forniti. Specifica inoltre il numero massimo di elementi nell'oggetto da serializzare e i parametri per specificare se i dati aggiuntivi vengono ignorati, il metodo di caricamento dell'assembly e un selettore surrogato.

public:
 NetDataContractSerializer(System::Runtime::Serialization::StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System::Runtime::Serialization::Formatters::FormatterAssemblyStyle assemblyFormat, System::Runtime::Serialization::ISurrogateSelector ^ surrogateSelector);
public NetDataContractSerializer(System.Runtime.Serialization.StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System.Runtime.Serialization.Formatters.FormatterAssemblyStyle assemblyFormat, System.Runtime.Serialization.ISurrogateSelector surrogateSelector);
new System.Runtime.Serialization.NetDataContractSerializer : System.Runtime.Serialization.StreamingContext * int * bool * System.Runtime.Serialization.Formatters.FormatterAssemblyStyle * System.Runtime.Serialization.ISurrogateSelector -> System.Runtime.Serialization.NetDataContractSerializer
Public Sub New (context As StreamingContext, maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, assemblyFormat As FormatterAssemblyStyle, surrogateSelector As ISurrogateSelector)

Parametri

context
StreamingContext

Oggetto StreamingContext contenente i dati di contesto.

maxItemsInObjectGraph
Int32

Numero massimo di elementi nel grafico da serializzare o deserializzare.

ignoreExtensionDataObject
Boolean

true per ignorare i dati forniti da un'estensione del tipo; in caso contrario, false.

assemblyFormat
FormatterAssemblyStyle

Valore FormatterAssemblyStyle di enumerazione che specifica un metodo per l'individuazione e il caricamento di assembly.

surrogateSelector
ISurrogateSelector

Implementazione di ISurrogateSelector.

Eccezioni

maxItemsInObjectGraph il valore è minore di 0.

Esempio

Nell'esempio seguente viene creata un'istanza NetDataContractSerializer di utilizzando un oggetto StreamingContext. Il codice imposta ignoreExtensionDataObjectanche e specifica un'implementazione dell'interfaccia ISurrogateSelector da gestire per facilitare il serializzatore quando si seleziona un surrogato (per deserializzare i tipi legacy).

public static void Constructor5()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);

    // Create an instance of a class that implements the
    // ISurrogateSelector interface. The implementation code
    // is not shown here.
    MySelector mySurrogateSelector = new MySelector();

    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        sc,
        int.MaxValue,
        true,
        FormatterAssemblyStyle.Simple,
        mySurrogateSelector);

    // Other code not shown.
}
Public Shared Sub Constructor5() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    
    ' Create an instance of a class that implements the 
    ' ISurrogateSelector interface. The implementation code
    ' is not shown here.
    Dim mySurrogateSelector As New MySelector()
    
    Dim ser As New System.Runtime.Serialization. _
    NetDataContractSerializer _
    (sc, _
     65536, _
     True, _
     FormatterAssemblyStyle.Simple, _
     mySurrogateSelector)

    ' Other code not shown.
End Sub

Commenti

Il ignoreExtensionDataObject parametro viene utilizzato quando l'interfaccia IExtensibleDataObject viene implementata nella classe che viene serializzata o deserializzata.

Si applica a

NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Inizializza una nuova istanza della NetDataContractSerializer classe con i dati di contesto forniti e il nome radice e lo spazio dei nomi. Specifica inoltre il numero massimo di elementi nell'oggetto da serializzare e i parametri per specificare se i dati aggiuntivi vengono ignorati, il metodo di caricamento dell'assembly e un selettore surrogato.

public:
 NetDataContractSerializer(System::String ^ rootName, System::String ^ rootNamespace, System::Runtime::Serialization::StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System::Runtime::Serialization::Formatters::FormatterAssemblyStyle assemblyFormat, System::Runtime::Serialization::ISurrogateSelector ^ surrogateSelector);
public NetDataContractSerializer(string rootName, string rootNamespace, System.Runtime.Serialization.StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System.Runtime.Serialization.Formatters.FormatterAssemblyStyle assemblyFormat, System.Runtime.Serialization.ISurrogateSelector surrogateSelector);
new System.Runtime.Serialization.NetDataContractSerializer : string * string * System.Runtime.Serialization.StreamingContext * int * bool * System.Runtime.Serialization.Formatters.FormatterAssemblyStyle * System.Runtime.Serialization.ISurrogateSelector -> System.Runtime.Serialization.NetDataContractSerializer
Public Sub New (rootName As String, rootNamespace As String, context As StreamingContext, maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, assemblyFormat As FormatterAssemblyStyle, surrogateSelector As ISurrogateSelector)

Parametri

rootName
String

Nome dell'elemento XML che racchiude il contenuto da serializzare o deserializzare.

rootNamespace
String

Spazio dei nomi dell'elemento XML che racchiude il contenuto da serializzare o deserializzare.

context
StreamingContext

Oggetto StreamingContext contenente i dati di contesto.

maxItemsInObjectGraph
Int32

Numero massimo di elementi nel grafico da serializzare o deserializzare.

ignoreExtensionDataObject
Boolean

true per ignorare i dati forniti da un'estensione del tipo; in caso contrario, false.

assemblyFormat
FormatterAssemblyStyle

Valore FormatterAssemblyStyle di enumerazione che specifica un metodo per l'individuazione e il caricamento di assembly.

surrogateSelector
ISurrogateSelector

Implementazione di IDataContractSurrogate per gestire il tipo legacy.

Eccezioni

maxItemsInObjectGraph il valore è minore di 0.

Esempio

Nell'esempio seguente viene creata un'istanza dell'oggetto specificando il nome dell'elemento NetDataContractSerializer XML e lo spazio dei nomi da prevedere durante la deserializzazione. Il codice imposta ignoreExtensionDataObjectanche e specifica un'implementazione dell'interfaccia ISurrogateSelector da gestire per facilitare il serializzatore quando si seleziona un surrogato (per deserializzare i tipi legacy).

public static void Constructor6()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);

    // Create an instance of a class that implements the
    // ISurrogateSelector interface. The implementation code
    // is not shown here.
    MySelector mySurrogateSelector = new MySelector();

    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        "Customer",
        "http://www.contoso.com",
        sc,
        int.MaxValue,
        true,
        FormatterAssemblyStyle.Simple,
        mySurrogateSelector);
    // Other code not shown.
}
Public Shared Sub Constructor6() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    
    ' Create an instance of a class that implements the 
    ' ISurrogateSelector interface. The implementation code
    ' is not shown here.
    Dim mySurrogateSelector As New MySelector()
    
    Dim ser As New System.Runtime.Serialization. _
      NetDataContractSerializer( _
      "Customer", _
      "http://www.contoso.com", _
      sc, _
      65536, _
      True, _
      FormatterAssemblyStyle.Simple, _
      mySurrogateSelector)

    ' Other code not shown.            

End Sub

Commenti

Il ignoreExtensionDataObject parametro viene utilizzato quando l'interfaccia IExtensibleDataObject viene implementata nella classe che viene serializzata o deserializzata.

Si applica a

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Inizializza una nuova istanza della NetDataContractSerializer classe con i dati di contesto forniti e il nome radice e lo spazio dei nomi (come XmlDictionaryString parametri); specifica inoltre il numero massimo di elementi nell'oggetto da serializzare e i parametri per specificare se i dati aggiuntivi trovati vengono ignorati, il metodo di caricamento dell'assembly e un selettore surrogato.

public:
 NetDataContractSerializer(System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace, System::Runtime::Serialization::StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System::Runtime::Serialization::Formatters::FormatterAssemblyStyle assemblyFormat, System::Runtime::Serialization::ISurrogateSelector ^ surrogateSelector);
public NetDataContractSerializer(System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace, System.Runtime.Serialization.StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System.Runtime.Serialization.Formatters.FormatterAssemblyStyle assemblyFormat, System.Runtime.Serialization.ISurrogateSelector surrogateSelector);
new System.Runtime.Serialization.NetDataContractSerializer : System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString * System.Runtime.Serialization.StreamingContext * int * bool * System.Runtime.Serialization.Formatters.FormatterAssemblyStyle * System.Runtime.Serialization.ISurrogateSelector -> System.Runtime.Serialization.NetDataContractSerializer
Public Sub New (rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString, context As StreamingContext, maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, assemblyFormat As FormatterAssemblyStyle, surrogateSelector As ISurrogateSelector)

Parametri

rootName
XmlDictionaryString

Oggetto XmlDictionaryString contenente l'elemento radice del contenuto.

rootNamespace
XmlDictionaryString

Oggetto XmlDictionaryString contenente lo spazio dei nomi dell'elemento radice.

context
StreamingContext

Oggetto StreamingContext contenente i dati di contesto.

maxItemsInObjectGraph
Int32

Numero massimo di elementi nel grafico da serializzare o deserializzare.

ignoreExtensionDataObject
Boolean

true per ignorare i dati forniti da un'estensione del tipo; in caso contrario, false.

assemblyFormat
FormatterAssemblyStyle

Valore FormatterAssemblyStyle di enumerazione che specifica un metodo per l'individuazione e il caricamento di assembly.

surrogateSelector
ISurrogateSelector

Implementazione di IDataContractSurrogate per gestire il tipo legacy.

Eccezioni

maxItemsInObjectGraph il valore è minore di 0.

Esempio

Nell'esempio seguente viene creata un'istanza dell'oggetto che specifica il nome dell'elemento NetDataContractSerializer XML e lo spazio dei nomi (come XmlDictionaryString argomenti) da prevedere durante la deserializzazione. Il codice imposta ignoreExtensionDataObjectanche e specifica un'implementazione dell'interfaccia ISurrogateSelector da gestire per facilitare il serializzatore quando si seleziona un surrogato (per deserializzare i tipi legacy).

public static void Constructor7()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);

    // Create an XmlDictionary and add values to it.
    XmlDictionary d = new XmlDictionary();
    XmlDictionaryString name_value = d.Add("Customer");
    XmlDictionaryString ns_value = d.Add("http://www.contoso.com");

    // Create an instance of a class that implements the
    // ISurrogateSelector interface. The implementation code
    // is not shown here.
    MySelector mySurrogateSelector = new MySelector();

    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        name_value,
        ns_value,
        sc,
        int.MaxValue,
        true,
        FormatterAssemblyStyle.Simple,
        mySurrogateSelector);

    // Other code not shown.
}
Public Shared Sub Constructor7() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    
    ' Create an XmlDictionary and add values to it.
    Dim d As New XmlDictionary()
    Dim name_value As XmlDictionaryString =d.Add("Customer")
    Dim ns_value As XmlDictionaryString = d.Add("http://www.contoso.com")
    
    ' Create an instance of a class that implements the 
    ' ISurrogateSelector interface. The implementation code
    ' is not shown here.
    Dim mySurrogateSelector As New MySelector()
    
    Dim ser As New System.Runtime.Serialization. _
      NetDataContractSerializer( _
      name_value, _
      ns_value, _
      sc, _
      65536, _
      True, _
      FormatterAssemblyStyle.Simple, _
      mySurrogateSelector)

    ' Other code not shown.    

End Sub

Commenti

XmlDictionaryString Può essere usato per ottimizzare le prestazioni quando lo stesso set di stringhe viene usato tra le istanze dell'oggetto.

Il ignoreExtensionDataObject parametro viene utilizzato quando l'interfaccia IExtensibleDataObject viene implementata nella classe che viene serializzata o deserializzata.

Si applica a