DataContractSerializer Konstruktoren

Definition

Namespace:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.Xml.dll

Initialisiert eine neue Instanz der DataContractSerializer-Klasse.

Überlädt

DataContractSerializer(Type)	Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren.
DataContractSerializer(Type, String, String, IEnumerable<Type>)	Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Darüber hinaus gibt diese Methode das XML-Stammelement und den Namespace in zwei Zeichenfolgenparametern sowie eine Liste bekannter Typen, die in dem Objektdiagramm ggf. enthalten sind, an.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)	Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs mithilfe des XML-Stammelements und -Namespaces zu serialisieren bzw. zu deserialisieren, das/der durch die Parameter des Typs XmlDictionaryString angegeben wird.
DataContractSerializer(Type, String, String)	Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs mithilfe des bereitgestellten XML-Stammelements und -Namespace zu serialisieren bzw. zu deserialisieren.
DataContractSerializer(Type, DataContractSerializerSettings)	Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs und Einstellungen zu serialisieren bzw. zu deserialisieren.
DataContractSerializer(Type, IEnumerable<Type>)	Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs sowie eine Auflistung bekannter Typen, die im Objektdiagramm vorhanden sind, zu serialisieren bzw. zu deserialisieren.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)	Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Darüber hinaus gibt diese Methode das XML-Stammelement und den Namespace in zwei XmlDictionaryString-Parametern sowie eine Liste bekannter Typen, die in dem Objektdiagramm ggf. enthalten sind, an.

DataContractSerializer(Type)

Quelle:

DataContractSerializer.cs

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren.

public:
 DataContractSerializer(Type ^ type);

public DataContractSerializer (Type type);

new System.Runtime.Serialization.DataContractSerializer : Type -> System.Runtime.Serialization.DataContractSerializer

Public Sub New (type As Type)

Parameter

type

Type

Der Typ der Instanzen, die serialisiert oder deserialisiert werden.

Beispiele

In dem folgenden Beispiel wird eine Instanz des DataContractSerializer-Objekts erstellt, das den zu serialisierenden bzw. zu deserialisierenden Typ angibt.

public static void Constructor1()
{
    // Create an instance of the DataContractSerializer.
    DataContractSerializer ser =
        new DataContractSerializer(typeof(Person));
    // Other code not shown.
}

 Public Shared Sub Constructor1() 
     ' Create an instance of the DataContractSerializer.
     Dim ser As New DataContractSerializer(GetType(Person))

     ' Other code not shown.    
 End Sub

DataContractSerializer(Type, String, String, IEnumerable<Type>)

Quelle:

DataContractSerializer.cs

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Darüber hinaus gibt diese Methode das XML-Stammelement und den Namespace in zwei Zeichenfolgenparametern sowie eine Liste bekannter Typen, die in dem Objektdiagramm ggf. enthalten sind, an.

public:
 DataContractSerializer(Type ^ type, System::String ^ rootName, System::String ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes);

public DataContractSerializer (Type type, string rootName, string rootNamespace, System.Collections.Generic.IEnumerable<Type>? knownTypes);

new System.Runtime.Serialization.DataContractSerializer : Type * string * string * seq<Type> -> System.Runtime.Serialization.DataContractSerializer

Public Sub New (type As Type, rootName As String, rootNamespace As String, knownTypes As IEnumerable(Of Type))

Parameter

type

Type

Der Typ der Instanzen, die serialisiert oder deserialisiert werden.

rootName

String

Der Stammelementname des Inhalts.

rootNamespace

String

Der Namespace des Stammelements.

knownTypes

IEnumerable<Type>

Ein IEnumerable<T>-Objekt des Typs Type, das die in dem Objektdiagramm enthaltenen Typen angibt (falls vorhanden).

Beispiele

Im folgenden Beispiel wird eine Instanz des DataContractSerializer-Objekts erstellt, das den zu serialisierenden bzw. zu deserialisierenden Typ sowie den XML-Namen und -Namespace angibt, der aus dem XML-Dokument gelesen bzw. in das XML-Dokument geschrieben wird. Der Code erstellt zudem eine IEnumerable<T>-Instanz, die die bekannten Typen enthält, die bei der Serialisierung oder Deserialisierung verwendet werden.

public static void Constructor5()
{
    // Create a generic List of types and add the known types
    // to the collection.
    List<Type> knownTypeList = new List<Type>();
    knownTypeList.Add(typeof(PurchaseOrder));
    knownTypeList.Add(typeof(PurchaseOrderV3));

    DataContractSerializer ser =
        new DataContractSerializer(
        typeof(Person),
        "Customer",
        @"http://www.contoso.com",
        knownTypeList);

    // Other code not shown.
}

Public Shared Sub Constructor5() 

    ' Create a generic List of types and add the known types
    ' to the collection.
    Dim knownTypeList As New List(Of Type)
    knownTypeList.Add(GetType(PurchaseOrder))
    knownTypeList.Add(GetType(PurchaseOrderV3))
    
    Dim ser As New DataContractSerializer(GetType(Person), _
    "Customer", _
    "http://www.contoso.com", _
    knownTypeList)

    ' Other code not shown.

End Sub

Weitere Informationen

• KnownTypes
• KnownTypeAttribute

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

Quelle:

DataContractSerializer.cs

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs mithilfe des XML-Stammelements und -Namespaces zu serialisieren bzw. zu deserialisieren, das/der durch die Parameter des Typs XmlDictionaryString angegeben wird.

public:
 DataContractSerializer(Type ^ type, System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace);

public DataContractSerializer (Type type, System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace);

new System.Runtime.Serialization.DataContractSerializer : Type * System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString -> System.Runtime.Serialization.DataContractSerializer

Public Sub New (type As Type, rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString)

Parameter

type

Type

Der Typ der Instanzen, die serialisiert oder deserialisiert werden.

rootName

XmlDictionaryString

Ein XmlDictionaryString-Objekt, das den Namen des Stammelements für den Inhalt enthält.

rootNamespace

XmlDictionaryString

Ein XmlDictionaryString-Objekt, das den Namespace des Stammelements enthält.

Beispiele

Im folgenden Beispiel wird eine Instanz des DataContractSerializer-Objekts erstellt, das den zu serialisierenden bzw. zu deserialisierenden Typ sowie den XML-Namen und -Namespace (als XmlDictionaryString-Objekte) angibt, der aus dem XML-Dokument gelesen bzw. in das XML-Dokument geschrieben wird.

public static void Constructor4()
{
    // Create an instance of the DataContractSerializer
    // specifying the type, and name and
    // namespace as XmlDictionaryString objects.

    // 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 the serializer.
    DataContractSerializer ser =
        new DataContractSerializer(
        typeof(Person),
        name_value,
        ns_value);
    // Other code not shown.
}

Public Shared Sub Constructor4() 
    ' Create an instance of the DataContractSerializer
    ' specifying the type, and name and 
    ' namespace as XmlDictionaryString objects.
    ' 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 DataContractSerializer(GetType(Person), _
    name_value, _
    ns_value)

    ' Other code not shown.
End Sub

DataContractSerializer(Type, String, String)

Quelle:

DataContractSerializer.cs

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs mithilfe des bereitgestellten XML-Stammelements und -Namespace zu serialisieren bzw. zu deserialisieren.

public:
 DataContractSerializer(Type ^ type, System::String ^ rootName, System::String ^ rootNamespace);

public DataContractSerializer (Type type, string rootName, string rootNamespace);

new System.Runtime.Serialization.DataContractSerializer : Type * string * string -> System.Runtime.Serialization.DataContractSerializer

Public Sub New (type As Type, rootName As String, rootNamespace As String)

Parameter

type

Type

Der Typ der Instanzen, die serialisiert oder deserialisiert werden.

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 Instanz des DataContractSerializer-Objekts erstellt, das den zu serialisierenden bzw. zu deserialisierenden Typ sowie den XML-Namen und -Namespace angibt, der aus dem XML-Dokument gelesen bzw. in das XML-Dokument geschrieben wird.

public static void Constructor3()
{
    // Create an instance of the DataContractSerializer
    // specifying the type, and name and
    // namespace as strings.
    DataContractSerializer ser =
        new DataContractSerializer(
        typeof(Person),
        "Customer",
        "http://www.contoso.com");

    // Other code not shown.
}

Public Shared Sub Constructor3() 
    ' Create an instance of the DataContractSerializer
    ' specifying the type, and name and 
    ' namespace as strings.
    Dim ser As New DataContractSerializer(GetType(Person), _
    "Customer", _
    "http://www.contoso.com")

    ' Other code not shown.
End Sub

DataContractSerializer(Type, DataContractSerializerSettings)

Quelle:

DataContractSerializer.cs

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs und Einstellungen zu serialisieren bzw. zu deserialisieren.

public:
 DataContractSerializer(Type ^ type, System::Runtime::Serialization::DataContractSerializerSettings ^ settings);

public DataContractSerializer (Type type, System.Runtime.Serialization.DataContractSerializerSettings? settings);

new System.Runtime.Serialization.DataContractSerializer : Type * System.Runtime.Serialization.DataContractSerializerSettings -> System.Runtime.Serialization.DataContractSerializer

Public Sub New (type As Type, settings As DataContractSerializerSettings)

Parameter

type

Type

Der Typ der Instanz, die serialisiert oder deserialisiert werden soll.

settings

DataContractSerializerSettings

Die Einstellungen des Serialisierungsprogramms

DataContractSerializer(Type, IEnumerable<Type>)

Quelle:

DataContractSerializer.cs

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs sowie eine Auflistung bekannter Typen, die im Objektdiagramm vorhanden sind, zu serialisieren bzw. zu deserialisieren.

public:
 DataContractSerializer(Type ^ type, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes);

public DataContractSerializer (Type type, System.Collections.Generic.IEnumerable<Type>? knownTypes);

new System.Runtime.Serialization.DataContractSerializer : Type * seq<Type> -> System.Runtime.Serialization.DataContractSerializer

Public Sub New (type As Type, knownTypes As IEnumerable(Of Type))

Parameter

type

Type

Der Typ der Instanzen, die serialisiert oder deserialisiert werden.

knownTypes

IEnumerable<Type>

Ein IEnumerable<T>-Objekt des Typs Type, das die in dem Objektdiagramm enthaltenen Typen angibt (falls vorhanden).

Beispiele

In dem folgenden Beispiel wird eine Instanz des DataContractSerializer-Objekts erstellt, das den zu serialisierenden bzw. zu deserialisierenden Typ sowie eine Auflistung bekannter Typen, die in dem Objektdiagramm verwendet werden können, angibt.

public static void Constructor2()
{
    // Create a generic List of types and add the known types
    // to the collection.
    List<Type> knownTypeList = new List<Type>();
    knownTypeList.Add(typeof(PurchaseOrder));
    knownTypeList.Add(typeof(PurchaseOrderV3));

    // Create a DatatContractSerializer with the collection.
    DataContractSerializer ser2 = new DataContractSerializer(
        typeof(Orders), knownTypeList);

    // Other code not shown.
}

 Public Shared Sub Constructor2() 

     ' Create a generic List of types and add the known types
     ' to the collection.
     Dim knownTypeList As New List(Of Type)
     knownTypeList.Add(GetType(PurchaseOrder))
     knownTypeList.Add(GetType(PurchaseOrderV3))
     
     ' Create a DatatContractSerializer with the collection.
     Dim ser2 As New DataContractSerializer(GetType(Orders), knownTypeList)

     ' Other code not shown.
End Sub

Weitere Informationen

• KnownTypes
• KnownTypeAttribute

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)

Quelle:

DataContractSerializer.cs

Initialisiert eine neue Instanz der DataContractSerializer-Klasse, um ein Objekt des genannten Typs zu serialisieren bzw. zu deserialisieren. Darüber hinaus gibt diese Methode das XML-Stammelement und den Namespace in zwei XmlDictionaryString-Parametern sowie eine Liste bekannter Typen, die in dem Objektdiagramm ggf. enthalten sind, an.

public:
 DataContractSerializer(Type ^ type, System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes);

public DataContractSerializer (Type type, System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace, System.Collections.Generic.IEnumerable<Type>? knownTypes);

new System.Runtime.Serialization.DataContractSerializer : Type * System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString * seq<Type> -> System.Runtime.Serialization.DataContractSerializer

Public Sub New (type As Type, rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString, knownTypes As IEnumerable(Of Type))

Parameter

type

Type

Der Typ der Instanzen, die serialisiert oder deserialisiert werden.

rootName

XmlDictionaryString

Ein XmlDictionaryString-Objekt, das den Namen des Stammelements für den Inhalt enthält.

rootNamespace

XmlDictionaryString

Ein XmlDictionaryString-Objekt, das den Namespace des Stammelements enthält.

knownTypes

IEnumerable<Type>

Ein IEnumerable<T>-Objekt des Typs Type, das die im Objektdiagramm enthaltenen bekannten Typen angibt (falls vorhanden).

Beispiele

Im folgenden Beispiel wird eine Instanz des DataContractSerializer-Objekts erstellt, das den zu serialisierenden bzw. zu deserialisierenden Typ sowie den XML-Namen und -Namespace (als XmlDictionaryString-Objekte) angibt, der aus dem XML-Dokument gelesen bzw. in das XML-Dokument geschrieben wird. Der Code erstellt zudem eine IEnumerable<T>-Instanz, die die bekannten Typen enthält, die bei der Serialisierung oder Deserialisierung verwendet werden.

public static void Constructor6()
{
    // Create a generic List of types and add the known types
    // to the collection.
    List<Type> knownTypeList = new List<Type>();
    knownTypeList.Add(typeof(PurchaseOrder));
    knownTypeList.Add(typeof(PurchaseOrderV3));

    // 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");

    DataContractSerializer ser =
        new DataContractSerializer(
        typeof(Person),
        name_value,
        ns_value,
        knownTypeList);

    // Other code not shown.
}

Public Shared Sub Constructor6() 
    ' Create a generic List of types and add the known types
    ' to the collection.
    Dim knownTypeList As New List(Of Type)
    knownTypeList.Add(GetType(PurchaseOrder))
    knownTypeList.Add(GetType(PurchaseOrderV3))

    ' 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")
    
    Dim ser As New DataContractSerializer(GetType(Person), _
    name_value, _
    ns_value, _
    knownTypeList)

    ' Other code not shown.
 End Sub

Weitere Informationen

• KnownTypes
• KnownTypeAttribute