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
| Name | Beschreibung |
|---|---|
| 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 bereitgestellten 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, mit dem der Inhalt angegeben wird. |
| NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initialisiert eine neue Instanz der NetDataContractSerializer Klasse mit den angegebenen Kontextdaten. Darüber hinaus wird die maximale Anzahl von Elementen im objekt serialisiert, und Parameter, um anzugeben, ob zusätzliche Daten ignoriert werden, die Assemblylademethode und eine Ersatzauswahl. |
| NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initialisiert eine neue Instanz der NetDataContractSerializer Klasse mit den bereitgestellten Kontextdaten und Stammnamen und Namespace. Darüber hinaus gibt die maximale Anzahl von Elementen im Objekt serialisiert werden soll, und Parameter, um anzugeben, ob zusätzliche Daten ignoriert werden, die Assemblylademethode und eine Ersatzauswahl. |
| NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initialisiert eine neue Instanz der NetDataContractSerializer Klasse mit den bereitgestellten Kontextdaten sowie dem Stammnamen und dem Namespace (als XmlDictionaryString Parameter). Darüber hinaus wird die maximale Anzahl von Elementen im Objekt serialisiert, und Parameter, um anzugeben, ob zusätzliche Gefundene ignoriert werden, Assemblylademethode und ein Ersatzmarkierer. |
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 Element, das Kontextdaten enthält.
Beispiele
Im folgenden Beispiel wird eine Instanz der NetDataContractSerializer Verwendung einer 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
Hinweise
Mit der StreamingContext Klasse können Sie benutzerspezifische Kontextdaten übergeben, die beim Lesen und Schreiben von Objekten verwendet werden sollen.
Gilt für:
NetDataContractSerializer(String, String)
Initialisiert eine neue Instanz der NetDataContractSerializer Klasse mit dem bereitgestellten 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 Inhalt umschließt, um den Inhalt zu serialisieren oder deserialisieren.
- rootNamespace
- String
Der Namespace des XML-Elements, das den Inhalt umschließt, um den Inhalt zu serialisieren oder deserialisieren.
Beispiele
Im folgenden Beispiel wird eine Instanz der DataContractSerializer Angabe des XML-Stammelements und des Namespaces erstellt, die beim Deserialisieren eines Objekts erwartet wird.
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, mit dem der Inhalt angegeben wird.
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
Eine XmlDictionaryString , die den Namen des XML-Elements enthält, das den Inhalt umschließt, um den Inhalt zu serialisieren oder deserialisieren.
- rootNamespace
- XmlDictionaryString
Eine XmlDictionaryString , die den Namespace des XML-Elements enthält, das den Inhalt umschließt, um den Inhalt zu serialisieren oder deserialisieren.
Beispiele
Im folgenden Beispiel wird eine Instanz der DataContractSerializer Angabe des XML-Stammelements und des Namespaces (als XmlDictionaryString Argumente) erstellt, die beim Deserialisieren eines Objekts erwartet wird.
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
Dies XmlDictionaryString kann verwendet werden, um die Leistung zu optimieren, wenn derselbe Satz von Zeichenfolgen über Objektinstanzen hinweg verwendet wird.
Gilt für:
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initialisiert eine neue Instanz der NetDataContractSerializer Klasse mit den angegebenen Kontextdaten. Darüber hinaus wird die maximale Anzahl von Elementen im objekt serialisiert, und Parameter, um anzugeben, ob zusätzliche Daten ignoriert werden, die Assemblylademethode und eine Ersatzauswahl.
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 Element, das Kontextdaten enthält.
- maxItemsInObjectGraph
- Int32
Die maximale Anzahl von Elementen im Diagramm, die serialisiert oder deserialisiert werden sollen.
- ignoreExtensionDataObject
- Boolean
truedie von einer Erweiterung des Typs bereitgestellten Daten zu ignorieren; andernfalls . false
- assemblyFormat
- FormatterAssemblyStyle
Ein FormatterAssemblyStyle Enumerationswert, der eine Methode zum Suchen und Laden von Assemblys angibt.
- surrogateSelector
- ISurrogateSelector
Eine Implementierung der ISurrogateSelector.
Ausnahmen
maxItemsInObjectGraph der Wert kleiner als 0 ist.
Beispiele
Im folgenden Beispiel wird eine Instanz der NetDataContractSerializer Verwendung einer StreamingContext. Der Code legt außerdem die ignoreExtensionDataObjectSchnittstelle fest und gibt eine Implementierung der ISurrogateSelector Schnittstelle an, die behandelt werden soll, um den Serialisierer beim Auswählen eines Ersatzes (für das Deserialisieren von Legacytypen) 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 Klasse implementiert wird, die serialisiert oder deserialisiert wird.
Gilt für:
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initialisiert eine neue Instanz der NetDataContractSerializer Klasse mit den bereitgestellten Kontextdaten und Stammnamen und Namespace. Darüber hinaus gibt die maximale Anzahl von Elementen im Objekt serialisiert werden soll, und Parameter, um anzugeben, ob zusätzliche Daten ignoriert werden, die Assemblylademethode und eine Ersatzauswahl.
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 Inhalt umschließt, um den Inhalt zu serialisieren oder deserialisieren.
- rootNamespace
- String
Der Namespace des XML-Elements, das den Inhalt umschließt, um den Inhalt zu serialisieren oder deserialisieren.
- context
- StreamingContext
Ein StreamingContext Element, das Kontextdaten enthält.
- maxItemsInObjectGraph
- Int32
Die maximale Anzahl von Elementen im Diagramm, die serialisiert oder deserialisiert werden sollen.
- ignoreExtensionDataObject
- Boolean
truedie von einer Erweiterung des Typs bereitgestellten 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 Legacytyps, der behandelt werden soll.
Ausnahmen
maxItemsInObjectGraph der Wert kleiner als 0 ist.
Beispiele
Im folgenden Beispiel wird eine Instanz der NetDataContractSerializer Angabe des XML-Elementnamens und des Namespaces erstellt, die beim Deserialisieren erwartet werden soll. Der Code legt außerdem die ignoreExtensionDataObjectSchnittstelle fest und gibt eine Implementierung der ISurrogateSelector Schnittstelle an, die behandelt werden soll, um den Serialisierer beim Auswählen eines Ersatzes (für das Deserialisieren von Legacytypen) 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 Klasse implementiert wird, die serialisiert oder deserialisiert wird.
Gilt für:
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initialisiert eine neue Instanz der NetDataContractSerializer Klasse mit den bereitgestellten Kontextdaten sowie dem Stammnamen und dem Namespace (als XmlDictionaryString Parameter). Darüber hinaus wird die maximale Anzahl von Elementen im Objekt serialisiert, und Parameter, um anzugeben, ob zusätzliche Gefundene ignoriert werden, Assemblylademethode und ein Ersatzmarkierer.
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 Element, das das Stammelement des Inhalts enthält.
- rootNamespace
- XmlDictionaryString
Eine XmlDictionaryString , die den Namespace des Stammelements enthält.
- context
- StreamingContext
Ein StreamingContext Element, das Kontextdaten enthält.
- maxItemsInObjectGraph
- Int32
Die maximale Anzahl von Elementen im Diagramm, die serialisiert oder deserialisiert werden sollen.
- ignoreExtensionDataObject
- Boolean
truedie von einer Erweiterung des Typs bereitgestellten 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 Legacytyps, der behandelt werden soll.
Ausnahmen
maxItemsInObjectGraph der Wert kleiner als 0 ist.
Beispiele
Im folgenden Beispiel wird eine Instanz der NetDataContractSerializer Angabe des XML-Elementnamens und des Namespaces (als XmlDictionaryString Argumente) erstellt, die beim Deserialisieren erwartet werden. Der Code legt außerdem die ignoreExtensionDataObjectSchnittstelle fest und gibt eine Implementierung der ISurrogateSelector Schnittstelle an, die behandelt werden soll, um den Serialisierer beim Auswählen eines Ersatzes (für das Deserialisieren von Legacytypen) 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
Dies XmlDictionaryString kann verwendet werden, um die Leistung zu optimieren, wenn derselbe Satz von Zeichenfolgen über Objektinstanzen hinweg verwendet wird.
Der ignoreExtensionDataObject Parameter wird verwendet, wenn die IExtensibleDataObject Schnittstelle in der Klasse implementiert wird, die serialisiert oder deserialisiert wird.