XmlSerializerFactory.CreateSerializer 方法

參考

定義

命名空間:: System.Xml.Serialization

組件:: System.Xml.XmlSerializer.dll

組件:: System.Xml.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

傳回用來序列化型別之 XmlSerializer 類別的衍生。

多載

CreateSerializer(Type)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。傳回用來序列化指定型別之 XmlSerializer 類別的衍生。
CreateSerializer(XmlTypeMapping)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。使用將某個型別對應到另一個型別的物件，傳回 XmlSerializer 類別的衍生。
CreateSerializer(Type, String)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。傳回用來序列化指定型別和命名空間 (Namespace) 之 XmlSerializer 類別的衍生。
CreateSerializer(Type, Type[])	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。傳回用來序列化指定型別之 XmlSerializer 類別的衍生。如果屬性或欄位傳回陣列，`extraTypes` 參數就會指定可插入陣列的物件。
CreateSerializer(Type, XmlAttributeOverrides)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。傳回 XmlSerializer 類別的衍生，此類別可將指定之型別的物件序列化為 XML 文件 (反之亦然)。每個要序列化的物件本身會包含類別執行個體，這個多載可以其他類別覆寫。
CreateSerializer(Type, XmlRootAttribute)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。傳回 XmlSerializer 類別的衍生，此類別可將指定之型別的物件序列化為 XML 文件 (反之亦然)。指定表示 XML 根項目 (Root Element) 的物件。
CreateSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。傳回 XmlSerializer 類別的衍生，此類別可將指定之型別的物件序列化為 XML 文件執行個體 (反之亦然)。每個要序列化的物件本身會包含類別執行個體，這個多載可以其他類別覆寫。這個多載也會指定所有 XML 項目的預設命名空間，以及要做為 XML 根項目的類別。
CreateSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String, String)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。傳回 XmlSerializer 類別的衍生，此類別可將指定之型別的物件序列化為 XML 文件執行個體 (反之亦然)。每個要序列化的物件本身會包含類別執行個體，這個多載可以其他類別覆寫。這個多載也會指定所有 XML 項目的預設命名空間，以及要做為 XML 根項目的類別。
CreateSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String, String, Evidence)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。已過時。傳回 XmlSerializer 類別的衍生，此類別可將指定之型別的物件序列化為 XML 文件執行個體 (反之亦然)。每個要序列化的物件本身會包含類別執行個體，這個多載可以其他類別覆寫。這個多載也會指定所有 XML 項目的預設命名空間，以及要做為 XML 根項目的類別。

CreateSerializer(Type)

傳回用來序列化指定型別之 XmlSerializer 類別的衍生。

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public:
 System::Xml::Serialization::XmlSerializer ^ CreateSerializer(Type ^ type);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type);

member this.CreateSerializer : Type -> System.Xml.Serialization.XmlSerializer

Public Function CreateSerializer (type As Type) As XmlSerializer

參數

type: Type

要序列化的 Type。

傳回

XmlSerializer

特別為序列化指定型別所建立之 XmlSerializer 類別的衍生。

適用於

CreateSerializer(XmlTypeMapping)

使用將某個型別對應到另一個型別的物件，傳回 XmlSerializer 類別的衍生。

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public:
 System::Xml::Serialization::XmlSerializer ^ CreateSerializer(System::Xml::Serialization::XmlTypeMapping ^ xmlTypeMapping);

public System.Xml.Serialization.XmlSerializer CreateSerializer (System.Xml.Serialization.XmlTypeMapping xmlTypeMapping);

member this.CreateSerializer : System.Xml.Serialization.XmlTypeMapping -> System.Xml.Serialization.XmlSerializer

Public Function CreateSerializer (xmlTypeMapping As XmlTypeMapping) As XmlSerializer

參數

xmlTypeMapping: XmlTypeMapping

將某個型別對應至另一個型別的 XmlTypeMapping。

傳回

XmlSerializer

特別為序列化對應型別所建立之 XmlSerializer 類別的衍生。

適用於

CreateSerializer(Type, String)

傳回用來序列化指定型別和命名空間 (Namespace) 之 XmlSerializer 類別的衍生。

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public:
 System::Xml::Serialization::XmlSerializer ^ CreateSerializer(Type ^ type, System::String ^ defaultNamespace);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, string? defaultNamespace);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, string defaultNamespace);

member this.CreateSerializer : Type * string -> System.Xml.Serialization.XmlSerializer

Public Function CreateSerializer (type As Type, defaultNamespace As String) As XmlSerializer

參數

type: Type

要序列化的 Type。

defaultNamespace: String

用於所有 XML 項目的預設命名空間。

傳回

XmlSerializer

特別為序列化指定型別所建立之 XmlSerializer 類別的衍生。

適用於

CreateSerializer(Type, Type[])

傳回用來序列化指定型別之 XmlSerializer 類別的衍生。如果屬性或欄位傳回陣列，extraTypes 參數就會指定可插入陣列的物件。

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public:
 System::Xml::Serialization::XmlSerializer ^ CreateSerializer(Type ^ type, cli::array <Type ^> ^ extraTypes);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, Type[]? extraTypes);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, Type[] extraTypes);

member this.CreateSerializer : Type * Type[] -> System.Xml.Serialization.XmlSerializer

Public Function CreateSerializer (type As Type, extraTypes As Type()) As XmlSerializer

參數

type: Type

要序列化的 Type。

extraTypes: Type[]

要序列化之其他物件型別的 Type 陣列。

傳回

XmlSerializer

XmlSerializer 的衍生。

備註

呼叫這個多載類似于呼叫 XmlSerializer(Type, Type[]) 來建立類別的 XmlSerializer 實例。

適用於

CreateSerializer(Type, XmlAttributeOverrides)

傳回 XmlSerializer 類別的衍生，此類別可將指定之型別的物件序列化為 XML 文件 (反之亦然)。每個要序列化的物件本身會包含類別執行個體，這個多載可以其他類別覆寫。

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public:
 System::Xml::Serialization::XmlSerializer ^ CreateSerializer(Type ^ type, System::Xml::Serialization::XmlAttributeOverrides ^ overrides);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides? overrides);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides overrides);

member this.CreateSerializer : Type * System.Xml.Serialization.XmlAttributeOverrides -> System.Xml.Serialization.XmlSerializer

Public Function CreateSerializer (type As Type, overrides As XmlAttributeOverrides) As XmlSerializer

參數

type: Type

要序列化的 Type。

overrides: XmlAttributeOverrides

XmlAttributeOverrides，其中含有覆寫預設序列化行為的欄位。

傳回

XmlSerializer

XmlSerializer 的衍生。

備註

呼叫這個多載類似于呼叫 XmlSerializer(Type, XmlAttributeOverrides) 來建立類別的 XmlSerializer 實例。

適用於

CreateSerializer(Type, XmlRootAttribute)

傳回 XmlSerializer 類別的衍生，此類別可將指定之型別的物件序列化為 XML 文件 (反之亦然)。指定表示 XML 根項目 (Root Element) 的物件。

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public:
 System::Xml::Serialization::XmlSerializer ^ CreateSerializer(Type ^ type, System::Xml::Serialization::XmlRootAttribute ^ root);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, System.Xml.Serialization.XmlRootAttribute? root);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, System.Xml.Serialization.XmlRootAttribute root);

member this.CreateSerializer : Type * System.Xml.Serialization.XmlRootAttribute -> System.Xml.Serialization.XmlSerializer

Public Function CreateSerializer (type As Type, root As XmlRootAttribute) As XmlSerializer

參數

type: Type

要序列化的 Type。

root: XmlRootAttribute

表示 XML 根項目的 XmlRootAttribute。

傳回

XmlSerializer

XmlSerializer 的衍生。

備註

呼叫這個多載類似于呼叫 XmlSerializer.XmlSerializer(Type, XmlRootAttribute) 來建立類別的 XmlSerializer 實例。

適用於

CreateSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String)

傳回 XmlSerializer 類別的衍生，此類別可將指定之型別的物件序列化為 XML 文件執行個體 (反之亦然)。每個要序列化的物件本身會包含類別執行個體，這個多載可以其他類別覆寫。這個多載也會指定所有 XML 項目的預設命名空間，以及要做為 XML 根項目的類別。

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public:
 System::Xml::Serialization::XmlSerializer ^ CreateSerializer(Type ^ type, System::Xml::Serialization::XmlAttributeOverrides ^ overrides, cli::array <Type ^> ^ extraTypes, System::Xml::Serialization::XmlRootAttribute ^ root, System::String ^ defaultNamespace);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides? overrides, Type[]? extraTypes, System.Xml.Serialization.XmlRootAttribute? root, string? defaultNamespace);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides overrides, Type[] extraTypes, System.Xml.Serialization.XmlRootAttribute root, string defaultNamespace);

member this.CreateSerializer : Type * System.Xml.Serialization.XmlAttributeOverrides * Type[] * System.Xml.Serialization.XmlRootAttribute * string -> System.Xml.Serialization.XmlSerializer

Public Function CreateSerializer (type As Type, overrides As XmlAttributeOverrides, extraTypes As Type(), root As XmlRootAttribute, defaultNamespace As String) As XmlSerializer

參數

type: Type

要序列化的 Type。

overrides: XmlAttributeOverrides

XmlAttributeOverrides，其中含有覆寫預設序列化行為的欄位。

extraTypes: Type[]

要序列化之其他物件型別的 Type 陣列。

root: XmlRootAttribute

表示 XML 根項目的 XmlRootAttribute。

defaultNamespace: String

XML 文件中所有 XML 項目的預設命名空間。

傳回

XmlSerializer

XmlSerializer 的衍生。

備註

呼叫這個多載類似于呼叫 XmlSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String) 來建立類別的 XmlSerializer 實例。

適用於

CreateSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String, String)

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public:
 System::Xml::Serialization::XmlSerializer ^ CreateSerializer(Type ^ type, System::Xml::Serialization::XmlAttributeOverrides ^ overrides, cli::array <Type ^> ^ extraTypes, System::Xml::Serialization::XmlRootAttribute ^ root, System::String ^ defaultNamespace, System::String ^ location);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides? overrides, Type[]? extraTypes, System.Xml.Serialization.XmlRootAttribute? root, string? defaultNamespace, string? location);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides overrides, Type[] extraTypes, System.Xml.Serialization.XmlRootAttribute root, string defaultNamespace, string location);

member this.CreateSerializer : Type * System.Xml.Serialization.XmlAttributeOverrides * Type[] * System.Xml.Serialization.XmlRootAttribute * string * string -> System.Xml.Serialization.XmlSerializer

Public Function CreateSerializer (type As Type, overrides As XmlAttributeOverrides, extraTypes As Type(), root As XmlRootAttribute, defaultNamespace As String, location As String) As XmlSerializer

參數

type: Type

這個 Type 可序列化的物件 XmlSerializer。

overrides: XmlAttributeOverrides

XmlAttributeOverrides，可延伸或覆寫在型別參數中指定的類別行為。

extraTypes: Type[]

要序列化之其他物件型別的 Type 陣列。

root: XmlRootAttribute

定義 XML 根項目屬性的 XmlRootAttribute。

defaultNamespace: String

XML 文件中所有 XML 項目的預設命名空間。

location: String

指定型別之位置的路徑。

傳回

XmlSerializer

XmlSerializer 的衍生。

適用於

CreateSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String, String, Evidence)

警告

This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateSerializer which does not take an Evidence parameter. See http://go2.microsoft.com/fwlink/?LinkId=131738 for more information.

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public:
 System::Xml::Serialization::XmlSerializer ^ CreateSerializer(Type ^ type, System::Xml::Serialization::XmlAttributeOverrides ^ overrides, cli::array <Type ^> ^ extraTypes, System::Xml::Serialization::XmlRootAttribute ^ root, System::String ^ defaultNamespace, System::String ^ location, System::Security::Policy::Evidence ^ evidence);

public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides overrides, Type[] extraTypes, System.Xml.Serialization.XmlRootAttribute root, string defaultNamespace, string location, System.Security.Policy.Evidence evidence);

[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateSerializer which does not take an Evidence parameter. See http://go2.microsoft.com/fwlink/?LinkId=131738 for more information.")]
public System.Xml.Serialization.XmlSerializer CreateSerializer (Type type, System.Xml.Serialization.XmlAttributeOverrides overrides, Type[] extraTypes, System.Xml.Serialization.XmlRootAttribute root, string defaultNamespace, string location, System.Security.Policy.Evidence evidence);

member this.CreateSerializer : Type * System.Xml.Serialization.XmlAttributeOverrides * Type[] * System.Xml.Serialization.XmlRootAttribute * string * string * System.Security.Policy.Evidence -> System.Xml.Serialization.XmlSerializer

[<System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateSerializer which does not take an Evidence parameter. See http://go2.microsoft.com/fwlink/?LinkId=131738 for more information.")>]
member this.CreateSerializer : Type * System.Xml.Serialization.XmlAttributeOverrides * Type[] * System.Xml.Serialization.XmlRootAttribute * string * string * System.Security.Policy.Evidence -> System.Xml.Serialization.XmlSerializer

Public Function CreateSerializer (type As Type, overrides As XmlAttributeOverrides, extraTypes As Type(), root As XmlRootAttribute, defaultNamespace As String, location As String, evidence As Evidence) As XmlSerializer

參數

type: Type

這個 Type 可序列化的物件 XmlSerializer。

overrides: XmlAttributeOverrides

XmlAttributeOverrides，可延伸或覆寫在型別參數中指定的類別行為。

extraTypes: Type[]

要序列化之其他物件型別的 Type 陣列。

root: XmlRootAttribute

定義 XML 根項目屬性的 XmlRootAttribute。

defaultNamespace: String

XML 文件中所有 XML 項目的預設命名空間。

location: String

指定型別之位置的路徑。

evidence: Evidence

Evidence 類別的執行個體，其中包含存取型別所需的認證。

傳回

XmlSerializer

XmlSerializer 的衍生。

屬性: ObsoleteAttribute

備註

呼叫這個多載類似于呼叫 XmlSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String, String, Evidence) 來建立類別的 XmlSerializer 實例。

適用於

共用方式為

XmlSerializerFactory.CreateSerializer 方法

定義

多載

CreateSerializer(Type)

參數

傳回

適用於

CreateSerializer(XmlTypeMapping)

參數

傳回

適用於

CreateSerializer(Type, String)

參數

傳回

適用於

CreateSerializer(Type, Type[])

參數

傳回

備註

適用於

CreateSerializer(Type, XmlAttributeOverrides)

參數

傳回

備註

適用於

CreateSerializer(Type, XmlRootAttribute)

參數

傳回

備註

適用於

CreateSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String)

參數

傳回

備註

適用於

CreateSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String, String)

參數

傳回

適用於

CreateSerializer(Type, XmlAttributeOverrides, Type[], XmlRootAttribute, String, String, Evidence)

參數

傳回

備註

適用於

其他資源