NetDataContractSerializer Costruttori
Definizione
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.
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.