NetDataContractSerializer Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse.
Überlädt
NetDataContractSerializer() |
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse. |
NetDataContractSerializer(StreamingContext) |
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit den bereitgestellten Streamingkontextdaten. |
NetDataContractSerializer(String, String) |
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit dem angegebenen XML-Stammelement und Namespace. |
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString) |
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit zwei Parametern vom Typ XmlDictionaryString, die das Stammelement und den Namespace enthalten, die zum Angeben des Inhalts verwendet werden. |
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit den angegebenen Kontextdaten. Weiterhin werden die maximal zu serialisierende Anzahl von Elementen in dem Objekt, Parameter zum Festlegen, ob zusätzliche Daten ignoriert werden, die Methoden zum Laden einer Assembly und ein Ersatzselektor angegeben. |
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit den angegebenen Kontextdaten, dem Stammnamen und dem Namespace. Weiterhin werden die maximal zu serialisierende Anzahl von Elementen in dem Objekt, Parameter zum Festlegen, ob zusätzliche Daten ignoriert werden, die Methoden zum Laden einer Assembly und ein Ersatzselektor angegeben. |
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit den angegebenen Kontextdaten, dem Stammnamen und dem Namespace (als XmlDictionaryString-Parameter). Weiterhin werden die maximal zu serialisierende Anzahl von Elementen in dem Objekt, Parameter zum Festlegen, ob zusätzliche Daten ignoriert werden, die Methoden zum Laden einer Assembly und ein Ersatzselektor angegeben. |
NetDataContractSerializer()
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse.
public:
NetDataContractSerializer();
public NetDataContractSerializer ();
Public Sub New ()
Beispiele
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.
Gilt für:
NetDataContractSerializer(StreamingContext)
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit den bereitgestellten Streamingkontextdaten.
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)
Parameter
- context
- StreamingContext
Ein StreamingContext-Objekt, das Kontextdaten enthält.
Beispiele
Im folgenden Beispiel wird eine Instanz des NetDataContractSerializer mit StreamingContext erstellt.
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
Hinweise
Die StreamingContext-Klasse ermöglicht die Übergabe in benutzerspezifischen Kontextdaten, die beim Lesen und Schreiben von Objekten verwendet werden können.
Gilt für:
NetDataContractSerializer(String, String)
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit dem angegebenen XML-Stammelement und Namespace.
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)
Parameter
- rootName
- String
Der Name des XML-Elements, das den zu serialisierenden bzw. zu deserialisierenden Inhalt enthält.
- rootNamespace
- String
Der Namespace des XML-Elements, das den zu serialisierenden bzw. zu deserialisierenden Inhalt enthält.
Beispiele
Im folgenden Beispiel wird eine DataContractSerializer-Instanz erstellt, und es werden das XML-Stammelement und der Namespace angegeben, die beim Deserialisieren eines Objekts erwartet werden.
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
Gilt für:
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit zwei Parametern vom Typ XmlDictionaryString, die das Stammelement und den Namespace enthalten, die zum Angeben des Inhalts verwendet werden.
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)
Parameter
- rootName
- XmlDictionaryString
Ein XmlDictionaryString-Objekt, das den Namen des XML-Elements angibt, das den zu serialisierenden bzw. zu deserialisierenden Inhalt enthält.
- rootNamespace
- XmlDictionaryString
Ein XmlDictionaryString-Objekt, das den Namespace des XML-Elements angibt, das den zu serialisierenden bzw. zu deserialisierenden Inhalt enthält.
Beispiele
Im folgenden Beispiel wird eine DataContractSerializer-Instanz erstellt, und es werden das XML-Stammelement und der Namespace (als XmlDictionaryString-Argumente) angegeben, die beim Deserialisieren eines Objekts erwartet werden.
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
Hinweise
XmlDictionaryString kann verwendet werden, um die Leistung zu steigern, wenn für mehrere Objektinstanzen die gleichen Zeichenfolgesätze genutzt werden.
Gilt für:
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit den angegebenen Kontextdaten. Weiterhin werden die maximal zu serialisierende Anzahl von Elementen in dem Objekt, Parameter zum Festlegen, ob zusätzliche Daten ignoriert werden, die Methoden zum Laden einer Assembly und ein Ersatzselektor angegeben.
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)
Parameter
- context
- StreamingContext
Ein StreamingContext-Objekt, das Kontextdaten enthält.
- maxItemsInObjectGraph
- Int32
Die maximale Anzahl von Elementen im Diagramm, die serialisiert oder deserialisiert werden soll.
- ignoreExtensionDataObject
- Boolean
true
, um die von einer Erweiterung des Typs angegebenen Daten zu ignorieren, andernfalls false
.
- assemblyFormat
- FormatterAssemblyStyle
Ein FormatterAssemblyStyle-Enumerationswert, der eine Methode zum Suchen und Laden von Assemblys angibt.
- surrogateSelector
- ISurrogateSelector
Eine Implementierung des ISurrogateSelector.
Ausnahmen
maxItemsInObjectGraph
-Wert ist kleiner als 0 (null).
Beispiele
Im folgenden Beispiel wird eine Instanz des NetDataContractSerializer mit StreamingContext erstellt. Der Code legt zudem den ignoreExtensionDataObject
-Parameter sowie eine Implementierung der ISurrogateSelector
-Schnittstelle fest, um das Serialisierungsprogramm bei der Auswahl eines Ersatzzeichens (zur Deserialisierung älterer Typen) zu unterstützen.
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
Hinweise
Der ignoreExtensionDataObject
-Parameter wird verwendet, wenn die IExtensibleDataObject-Schnittstelle in der serialisierten bzw. deserialisierten Klasse implementiert ist.
Gilt für:
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit den angegebenen Kontextdaten, dem Stammnamen und dem Namespace. Weiterhin werden die maximal zu serialisierende Anzahl von Elementen in dem Objekt, Parameter zum Festlegen, ob zusätzliche Daten ignoriert werden, die Methoden zum Laden einer Assembly und ein Ersatzselektor angegeben.
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)
Parameter
- rootName
- String
Der Name des XML-Elements, das den zu serialisierenden bzw. zu deserialisierenden Inhalt enthält.
- rootNamespace
- String
Der Namespace des XML-Elements, das den zu serialisierenden bzw. zu deserialisierenden Inhalt enthält.
- context
- StreamingContext
Ein StreamingContext-Objekt, das Kontextdaten enthält.
- maxItemsInObjectGraph
- Int32
Die maximale Anzahl von Elementen im Diagramm, die serialisiert oder deserialisiert werden soll.
- ignoreExtensionDataObject
- Boolean
true
, um die von einer Erweiterung des Typs angegebenen Daten zu ignorieren, andernfalls false
.
- assemblyFormat
- FormatterAssemblyStyle
Ein FormatterAssemblyStyle-Enumerationswert, der eine Methode zum Suchen und Laden von Assemblys angibt.
- surrogateSelector
- ISurrogateSelector
Eine Implementierung des IDataContractSurrogate für die Verarbeitung älterer Typen.
Ausnahmen
maxItemsInObjectGraph
-Wert ist kleiner als 0 (null).
Beispiele
Im folgenden Beispiel wird eine NetDataContractSerializer-Instanz erstellt, und es werden der Name und Namespace des XML-Elements angegeben, die beim Deserialisieren eines Objekts erwartet werden. Der Code legt zudem den ignoreExtensionDataObject
-Parameter sowie eine Implementierung der ISurrogateSelector-Schnittstelle fest, um das Serialisierungsprogramm bei der Auswahl eines Ersatzzeichens (zur Deserialisierung älterer Typen) zu unterstützen.
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
Hinweise
Der ignoreExtensionDataObject
-Parameter wird verwendet, wenn die IExtensibleDataObject-Schnittstelle in der serialisierten bzw. deserialisierten Klasse implementiert ist.
Gilt für:
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initialisiert eine neue Instanz der NetDataContractSerializer-Klasse mit den angegebenen Kontextdaten, dem Stammnamen und dem Namespace (als XmlDictionaryString-Parameter). Weiterhin werden die maximal zu serialisierende Anzahl von Elementen in dem Objekt, Parameter zum Festlegen, ob zusätzliche Daten ignoriert werden, die Methoden zum Laden einer Assembly und ein Ersatzselektor angegeben.
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)
Parameter
- rootName
- XmlDictionaryString
Ein XmlDictionaryString-Objekt, das das Stammelement des Inhalts enthält.
- rootNamespace
- XmlDictionaryString
Ein XmlDictionaryString-Objekt, das den Namespace des Stammelements enthält.
- context
- StreamingContext
Ein StreamingContext-Objekt, das Kontextdaten enthält.
- maxItemsInObjectGraph
- Int32
Die maximale Anzahl von Elementen im Diagramm, die serialisiert oder deserialisiert werden soll.
- ignoreExtensionDataObject
- Boolean
true
, um die von einer Erweiterung des Typs angegebenen Daten zu ignorieren, andernfalls false
.
- assemblyFormat
- FormatterAssemblyStyle
Ein FormatterAssemblyStyle-Enumerationswert, der eine Methode zum Suchen und Laden von Assemblys angibt.
- surrogateSelector
- ISurrogateSelector
Eine Implementierung des IDataContractSurrogate für die Verarbeitung älterer Typen.
Ausnahmen
maxItemsInObjectGraph
-Wert ist kleiner als 0 (null).
Beispiele
Im folgenden Beispiel wird eine NetDataContractSerializer-Instanz erstellt, und es werden der Name und Namespace des XML-Elements (als XmlDictionaryString-Argumente) angegeben, die beim Deserialisieren erwartet werden. Der Code legt zudem den ignoreExtensionDataObject
-Parameter sowie eine Implementierung der ISurrogateSelector-Schnittstelle fest, um das Serialisierungsprogramm bei der Auswahl eines Ersatzzeichens (zur Deserialisierung älterer Typen) zu unterstützen.
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
Hinweise
XmlDictionaryString kann verwendet werden, um die Leistung zu steigern, wenn für mehrere Objektinstanzen die gleichen Zeichenfolgesätze genutzt werden.
Der ignoreExtensionDataObject
-Parameter wird verwendet, wenn die IExtensibleDataObject-Schnittstelle in der serialisierten bzw. deserialisierten Klasse implementiert ist.