NetDataContractSerializer Konstruktoren

Definition

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.

Gilt für: