NetDataContractSerializer Konstruktoren

Definition

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.

Gilt für: