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 類別的新執行個體，以便序列化或還原序列化所指定型別的物件 (該型別會使用透過型別 XmlDictionaryString 之參數所指定的 XML 根項目和命名空間)。
DataContractSerializer(Type, String, String)	初始化 DataContractSerializer 類別的新執行個體，以便序列化或還原序列化已指定型別的物件 (該型別會使用提供的 XML 根項目和命名空間)。
DataContractSerializer(Type, DataContractSerializerSettings)	初始化 DataContractSerializer 類別的新執行個體，以序列化或還原序列化所指定型別及設定的物件。
DataContractSerializer(Type, IEnumerable<Type>)	初始化 DataContractSerializer 類別的新執行個體，以序列化或還原序列化所指定型別的物件，以及可能存在物件圖形中的已知型別集合。
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)	初始化 DataContractSerializer 類別的新執行個體，以序列化或還原序列化所指定型別的物件。 這個方法也會透過兩個 XmlDictionaryString 參數來指定根 XML 項目和命名空間，以及可能存在於物件圖形內之已知型別的清單。

DataContractSerializer(Type)

來源:

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

來源:

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)

來源:

DataContractSerializer.cs

初始化 DataContractSerializer 類別的新執行個體，以便序列化或還原序列化所指定型別的物件 (該型別會使用透過型別 XmlDictionaryString 之參數所指定的 XML 根項目和命名空間)。

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)

來源:

DataContractSerializer.cs

初始化 DataContractSerializer 類別的新執行個體，以便序列化或還原序列化已指定型別的物件 (該型別會使用提供的 XML 根項目和命名空間)。

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)

來源:

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

來源:

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

來源:

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