DataContractSerializer 构造函数

定义

命名空间:

System.Runtime.Serialization

程序集:

System.Runtime.Serialization.Xml.dll

初始化 DataContractSerializer 类的新实例。

重载

DataContractSerializer(Type)	初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型的对象。
DataContractSerializer(Type, String, String, IEnumerable<Type>)	初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型的对象。 此方法还在两个字符串参数中指定根 XML 元素和命名空间，并指定了可在对象图中呈现的已知类型的列表。
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)	使用通过类型为 DataContractSerializer 的参数指定的 XML 根元素和命名空间初始化 XmlDictionaryString 类的新实例，以便序列化或反序列化指定类型的对象。
DataContractSerializer(Type, String, String)	使用提供的 XML 根元素和命名空间初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型的对象。
DataContractSerializer(Type, DataContractSerializerSettings)	初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型和设置的对象。
DataContractSerializer(Type, IEnumerable<Type>)	初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型的对象以及可在对象图中呈现的已知类型的集合。
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)	初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型的对象。 此方法还在两个 XmlDictionaryString 参数中指定根 XML 元素和命名空间，并指定了可在对象图中呈现的已知类型的列表。

DataContractSerializer(Type)

Source:

DataContractSerializer.cs

初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型的对象。

public:
 DataContractSerializer(Type ^ type);

public DataContractSerializer (Type type);

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

Public Sub New (type As Type)

参数

type

Type

序列化或反序列化的实例的类型。

示例

下面的示例创建一个 DataContractSerializer 实例，以便指定要序列化或反序列化的类型。

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>)

Source:

DataContractSerializer.cs

初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型的对象。 此方法还在两个字符串参数中指定根 XML 元素和命名空间，并指定了可在对象图中呈现的已知类型的列表。

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))

参数

type

Type

序列化或反序列化的实例的类型。

rootName

String

内容的根元素名称。

rootNamespace

String

根元素的命名空间。

knownTypes

IEnumerable<Type>

IEnumerable<T> 的一个 Type，其中包含可在对象图中呈现的类型。

示例

下面的示例创建一个 DataContractSerializer 实例，它指定了要序列化或反序列化的类型以及在 XML 文档中读取或写入的 XML 名称和命名空间。 该代码还创建一个 IEnumerable<T> 实例，以包含在序列化或反序列化期间使用的已知类型。

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

另请参阅

• KnownTypes
• KnownTypeAttribute

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

Source:

DataContractSerializer.cs

使用通过类型为 DataContractSerializer 的参数指定的 XML 根元素和命名空间初始化 XmlDictionaryString 类的新实例，以便序列化或反序列化指定类型的对象。

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)

参数

type

Type

序列化或反序列化的实例的类型。

rootName

XmlDictionaryString

一个包含内容的根元素名称的 XmlDictionaryString。

rootNamespace

XmlDictionaryString

一个包含根元素的命名空间的 XmlDictionaryString。

示例

下面的示例创建一个 DataContractSerializer 实例，它指定了要序列化或反序列化的类型以及在 XML 文档中读取或写入的 XML 名称和命名空间（作为 XmlDictionaryString 参数）。

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)

Source:

DataContractSerializer.cs

使用提供的 XML 根元素和命名空间初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型的对象。

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)

参数

type

Type

序列化或反序列化的实例的类型。

rootName

String

XML 元素的名称，该元素包含要序列化或反序列化的内容。

rootNamespace

String

XML 元素的命名空间，该元素包含要序列化或反序列化的内容。

示例

下面的示例创建一个 DataContractSerializer 实例，它指定了要序列化或反序列化的类型以及在 XML 文档中读取或写入的 XML 名称和命名空间。

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)

Source:

DataContractSerializer.cs

初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型和设置的对象。

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)

参数

type

Type

被序列化或反序列化的实例类型。

settings

DataContractSerializerSettings

序列化程序设置。

DataContractSerializer(Type, IEnumerable<Type>)

Source:

DataContractSerializer.cs

初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型的对象以及可在对象图中呈现的已知类型的集合。

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))

参数

type

Type

序列化或反序列化的实例的类型。

knownTypes

IEnumerable<Type>

IEnumerable<T> 的一个 Type，其中包含可在对象图中呈现的类型。

示例

下面的示例创建一个 DataContractSerializer 实例，它指定了要序列化或反序列化的类型以及可在对象图中使用的已知类型的集合。

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

另请参阅

• KnownTypes
• KnownTypeAttribute

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

Source:

DataContractSerializer.cs

初始化 DataContractSerializer 类的新实例，以便序列化或反序列化指定类型的对象。 此方法还在两个 XmlDictionaryString 参数中指定根 XML 元素和命名空间，并指定了可在对象图中呈现的已知类型的列表。

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))

参数

type

Type

序列化或反序列化的实例的类型。

rootName

XmlDictionaryString

一个包含内容的根元素名称的 XmlDictionaryString。

rootNamespace

XmlDictionaryString

一个包含根元素的命名空间的 XmlDictionaryString。

knownTypes

IEnumerable<Type>

IEnumerable<T> 的一个 Type，其中包含可在对象图中呈现的已知类型。

示例

下面的示例创建一个 DataContractSerializer 实例，它指定了要序列化或反序列化的类型以及在 XML 文档中读取或写入的 XML 名称和命名空间（作为 XmlDictionaryString 参数）。 该代码还创建一个 IEnumerable<T> 实例，以包含在序列化或反序列化期间使用的已知类型。

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

另请参阅

• KnownTypes
• KnownTypeAttribute