Partager via


DataContractSerializer Constructeurs

Définition

Initialise une nouvelle instance de la classe DataContractSerializer.

Surcharges

DataContractSerializer(Type)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, les paramètres de XmlDictionaryString qui spécifient l'élément et l'espace de noms XML qui contient le contenu, ainsi qu'une autre approche pour mapper des déclarations xsi:type au moment de l'exécution.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, l'élément et l'espace de noms XML qui contient le contenu, ainsi qu'une autre approche pour mapper des déclarations xsi:type au moment de l'exécution.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer les données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, et les paramètres XmlDictionaryString qui spécifient l'élément et l'espace de noms XML qui contiennent le contenu.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, ainsi que l'élément et l'espace de noms XML qui incluent le contenu.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer les données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, et un substitut pour la sérialisation personnalisée.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, ainsi qu'une autre approche pour mapper des déclarations xsi:type au moment de l'exécution.

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

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également l'élément XML racine et l'espace de noms dans deux paramètres de chaîne ainsi qu'une liste des types connus pouvant être présents dans le graphique d'objets.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié à l'aide de l'élément racine et de l'espace de noms XML spécifiés dans les paramètres de type XmlDictionaryString.

DataContractSerializer(Type, String, String)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié à l'aide de l'élément racine et de l'espace de noms XML fournis.

DataContractSerializer(Type, DataContractSerializerSettings)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet avec le type et les paramètres spécifiés.

DataContractSerializer(Type, IEnumerable<Type>)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié, et une collection de types connus pouvant être présents dans le graphique d'objets.

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

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également l'élément XML racine et l'espace de noms dans deux paramètres XmlDictionaryString ainsi qu'une liste de types connus pouvant être présents dans le graphique d'objets.

DataContractSerializer(Type)

Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié.

public:
 DataContractSerializer(Type ^ type);
public DataContractSerializer (Type type);
new System.Runtime.Serialization.DataContractSerializer : Type -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type)

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

Exemples

L'exemple suivant crée une instance de la classe DataContractSerializer qui spécifie le type à sérialiser ou désérialiser.

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

S’applique à

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, les paramètres de XmlDictionaryString qui spécifient l'élément et l'espace de noms XML qui contient le contenu, ainsi qu'une autre approche pour mapper des déclarations xsi:type au moment de l'exécution.

public:
 DataContractSerializer(Type ^ type, System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate, System::Runtime::Serialization::DataContractResolver ^ dataContractResolver);
public DataContractSerializer (Type type, System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate, System.Runtime.Serialization.DataContractResolver dataContractResolver);
new System.Runtime.Serialization.DataContractSerializer : Type * System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate * System.Runtime.Serialization.DataContractResolver -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate, dataContractResolver As DataContractResolver)

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

rootName
XmlDictionaryString

Élément XML renfermant le contenu à sérialiser ou désérialiser.

rootNamespace
XmlDictionaryString

Espace de noms de l'élément XML renfermant le contenu à sérialiser ou désérialiser.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type qui contient les types connus pouvant être présents dans le graphique d'objets.

maxItemsInObjectGraph
Int32

Nombre maximal d'éléments à sérialiser ou désérialiser dans le graphique.

ignoreExtensionDataObject
Boolean

true pour ignorer les données fournies par une extension du type lors de la sérialisation et désérialisation ; sinon, false.

preserveObjectReferences
Boolean

true pour utiliser des constructions XML non standard afin de conserver les données de référence d'objet ; sinon, false.

dataContractSurrogate
IDataContractSurrogate

Implémentation du IDataContractSurrogate pour personnaliser le processus de sérialisation.

dataContractResolver
DataContractResolver

Implémentation de la classe DataContractResolver pour mapper des déclarations xsi:type à des types de contrat de données.

S’applique à

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, l'élément et l'espace de noms XML qui contient le contenu, ainsi qu'une autre approche pour mapper des déclarations xsi:type au moment de l'exécution.

public:
 DataContractSerializer(Type ^ type, System::String ^ rootName, System::String ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate, System::Runtime::Serialization::DataContractResolver ^ dataContractResolver);
public DataContractSerializer (Type type, string rootName, string rootNamespace, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate, System.Runtime.Serialization.DataContractResolver dataContractResolver);
new System.Runtime.Serialization.DataContractSerializer : Type * string * string * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate * System.Runtime.Serialization.DataContractResolver -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As String, rootNamespace As String, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate, dataContractResolver As DataContractResolver)

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

rootName
String

Élément XML renfermant le contenu à sérialiser ou désérialiser.

rootNamespace
String

Espace de noms de l'élément XML renfermant le contenu à sérialiser ou désérialiser.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type qui contient les types connus pouvant être présents dans le graphique d'objets.

maxItemsInObjectGraph
Int32

Nombre maximal d'éléments à sérialiser ou désérialiser dans le graphique.

ignoreExtensionDataObject
Boolean

true pour ignorer les données fournies par une extension du type lors de la sérialisation et désérialisation ; sinon, false.

preserveObjectReferences
Boolean

true pour utiliser des constructions XML non standard afin de conserver les données de référence d'objet ; sinon, false.

dataContractSurrogate
IDataContractSurrogate

Implémentation du IDataContractSurrogate pour personnaliser le processus de sérialisation.

dataContractResolver
DataContractResolver

Implémentation de la classe DataContractResolver pour mapper des déclarations xsi:type à des types de contrat de données.

S’applique à

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer les données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, et les paramètres XmlDictionaryString qui spécifient l'élément et l'espace de noms XML qui contiennent le contenu.

public:
 DataContractSerializer(Type ^ type, System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate);
public DataContractSerializer (Type type, System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate);
new System.Runtime.Serialization.DataContractSerializer : Type * System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate)

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

rootName
XmlDictionaryString

Classe XmlDictionaryString qui spécifie l'élément XML renfermant le contenu à sérialiser ou désérialiser.

rootNamespace
XmlDictionaryString

XmlDictionaryString qui spécifie l'espace de noms XML de la racine.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type qui contient les types connus pouvant être présents dans le graphique d'objets.

maxItemsInObjectGraph
Int32

Nombre maximal d'éléments à sérialiser ou désérialiser dans le graphique.

ignoreExtensionDataObject
Boolean

true pour ignorer les données fournies par une extension du type lors de la sérialisation et désérialisation ; sinon, false.

preserveObjectReferences
Boolean

true pour utiliser des constructions XML non standard afin de conserver les données de référence d'objet ; sinon, false.

dataContractSurrogate
IDataContractSurrogate

Implémentation du IDataContractSurrogate pour personnaliser le processus de sérialisation.

Exceptions

Le nombre d'éléments dépasse la valeur maximale.

Exemples

L’exemple suivant crée une instance de la classe DataContractSerializer qui spécifie le type à sérialiser ou désérialiser, l’élément et l’espace de noms XML racine (sous forme de paramètres XmlDictionaryString) et une instance d’interface IEnumerable<T> qui contient les types utilisés pendant la désérialisation. Le code définit également les ignoreExtensionDataObject paramètres et preserveObjectReferences sur true, et spécifie une implémentation de l’interface pour gérer les IDataContractSurrogate types hérités (types qui n’ont pas l’attribut DataContractAttribute appliqué). Pour plus d’informations, consultez la documentation de IDataContractSurrogate.

public static void Constructor9()
{
    // 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");

    // Create an instance of a class that
    // implements the IDataContractSurrogate interface.
    // The implementation code is not shown here.
    DCSurrogate mySurrogate = new DCSurrogate();

    DataContractSerializer ser =
        new DataContractSerializer(
        typeof(Person),
        name_value,
        ns_value,
        knownTypeList,
        64 * 1024,
        true,
        true,
        mySurrogate);

    // Other code not shown.
}
Public Shared Sub Constructor9() 

    ' 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")
    
    ' Create an instance of a class that 
    ' implements the IDataContractSurrogate interface.
    ' The implementation code is not shown here.
    Dim mySurrogate As New DCSurrogate()
    
    Dim ser As New DataContractSerializer(GetType(Person), _
    name_value, _
    ns_value, _
    knownTypeList, _
    64 * 1064, _
    True, _
    True, _
    mySurrogate)

    ' Other code not shown.    

End Sub

Voir aussi

S’applique à

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, ainsi que l'élément et l'espace de noms XML qui incluent le contenu.

public:
 DataContractSerializer(Type ^ type, System::String ^ rootName, System::String ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate);
public DataContractSerializer (Type type, string rootName, string rootNamespace, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate);
new System.Runtime.Serialization.DataContractSerializer : Type * string * string * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As String, rootNamespace As String, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate)

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

rootName
String

Élément XML renfermant le contenu à sérialiser ou désérialiser.

rootNamespace
String

Espace de noms de l'élément XML renfermant le contenu à sérialiser ou désérialiser.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type qui contient les types connus pouvant être présents dans le graphique d'objets.

maxItemsInObjectGraph
Int32

Nombre maximal d'éléments à sérialiser ou désérialiser dans le graphique.

ignoreExtensionDataObject
Boolean

true pour ignorer les données fournies par une extension du type lors de la sérialisation et désérialisation ; sinon, false.

preserveObjectReferences
Boolean

true pour utiliser des constructions XML non standard afin de conserver les données de référence d'objet ; sinon, false.

dataContractSurrogate
IDataContractSurrogate

Implémentation du IDataContractSurrogate pour personnaliser le processus de sérialisation.

Exceptions

Le nombre d'éléments dépasse la valeur maximale.

Exemples

L’exemple suivant crée une instance de la classe DataContractSerializer qui spécifie le type à sérialiser ou désérialiser, l’élément et l’espace de noms XML racine, et une instance d’une interface IEnumerable<T> qui contient les types utilisés pendant la désérialisation. Le code définit également les ignoreExtensionDataObject paramètres et preserveObjectReferences sur true, et spécifie une implémentation de l’interface pour gérer les IDataContractSurrogate types hérités (types qui n’ont pas l’attribut DataContractAttribute appliqué). Pour plus d’informations, consultez la documentation de IDataContractSurrogate.

public static void Constructor8()
{
    // 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 instance of a class that
    // implements the IDataContractSurrogate interface.
    // The implementation code is not shown here.
    DCSurrogate mySurrogate = new DCSurrogate();

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

    // Other code not shown.
}
Public Shared Sub Constructor8() 

    ' 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 instance of a class that 
    ' implements the IDataContractSurrogate interface.
    ' The implementation code is not shown here.
    Dim mySurrogate As New DCSurrogate()

    Dim ser As New DataContractSerializer(GetType(Person), _
    "Customer", _
    "http://www.contoso.com", _
    knownTypeList, _
    64 * 1064, _
    True, _
    True, _
    mySurrogate)

    ' Other code not shown.
End Sub

Voir aussi

S’applique à

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer les données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, et un substitut pour la sérialisation personnalisée.

public:
 DataContractSerializer(Type ^ type, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate);
public DataContractSerializer (Type type, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate);
new System.Runtime.Serialization.DataContractSerializer : Type * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate)

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type qui contient les types connus pouvant être présents dans le graphique d'objets.

maxItemsInObjectGraph
Int32

Nombre maximal d'éléments à sérialiser ou désérialiser dans le graphique. La valeur par défaut est la valeur retournée par la propriété Int32.MaxValue .

ignoreExtensionDataObject
Boolean

true pour ignorer les données fournies par une extension du type lors de la sérialisation et désérialisation ; sinon, false.

preserveObjectReferences
Boolean

true pour utiliser des constructions XML non standard afin de conserver les données de référence d'objet ; sinon, false.

dataContractSurrogate
IDataContractSurrogate

Implémentation du IDataContractSurrogate pour personnaliser le processus de sérialisation.

Exceptions

Le nombre d'éléments dépasse la valeur maximale.

Exemples

L’exemple suivant crée une instance de la classe DataContractSerializer qui spécifie le type à sérialiser ou désérialiser et une instance d’une interface IEnumerable<T> pour contenir les types connus utilisés pendant la sérialisation ou la désérialisation. Le code définit également les ignoreExtensionDataObject paramètres trueet preserveObjectReferences sur , et spécifie une implémentation de l’interface IDataContractSurrogate pour gérer les types hérités (types dont l’attribut DataContractAttribute n’est pas appliqué). Pour plus d’informations, consultez la documentation de IDataContractSurrogate.

public static void Constructor7()
{
    // 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 instance of a class that
    // implements the IDataContractSurrogate interface.
    // The implementation code is not shown here.
    DCSurrogate mySurrogate = new DCSurrogate();

    DataContractSerializer ser =
        new DataContractSerializer(
        typeof(Person),
        knownTypeList,
        64 * 1024,
        true,
        true,
        mySurrogate);
    // Other code not shown.
}
Public Shared Sub Constructor7() 

    ' 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 instance of a class that 
    ' implements the IDataContractSurrogate interface.
    ' The implementation code is not shown here.
    Dim mySurrogate As New DCSurrogate()

    Dim ser As New DataContractSerializer(GetType(Person), _
    knownTypeList, _
    64 * 1064, _
    True, _
    True, _
     mySurrogate)

    ' Other code not shown.
End Sub

Voir aussi

S’applique à

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, ainsi qu'une autre approche pour mapper des déclarations xsi:type au moment de l'exécution.

public:
 DataContractSerializer(Type ^ type, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate, System::Runtime::Serialization::DataContractResolver ^ dataContractResolver);
public DataContractSerializer (Type type, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate, System.Runtime.Serialization.DataContractResolver dataContractResolver);
new System.Runtime.Serialization.DataContractSerializer : Type * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate * System.Runtime.Serialization.DataContractResolver -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate, dataContractResolver As DataContractResolver)

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type qui contient les types connus pouvant être présents dans le graphique d'objets.

maxItemsInObjectGraph
Int32

Nombre maximal d'éléments à sérialiser ou désérialiser dans le graphique. La valeur par défaut est la valeur retournée par la propriété Int32.MaxValue .

ignoreExtensionDataObject
Boolean

true pour ignorer les données fournies par une extension du type lors de la sérialisation et désérialisation ; sinon, false.

preserveObjectReferences
Boolean

true pour utiliser des constructions XML non standard afin de conserver les données de référence d'objet ; sinon, false.

dataContractSurrogate
IDataContractSurrogate

Implémentation du IDataContractSurrogate pour personnaliser le processus de sérialisation.

dataContractResolver
DataContractResolver

Implémentation de la classe DataContractResolver pour mapper des déclarations xsi:type à des types de contrat de données.

Remarques

Avertissement

Cette méthode n’est pas disponible dans les applications du Windows Store.

S’applique à

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

Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également l'élément XML racine et l'espace de noms dans deux paramètres de chaîne ainsi qu'une liste des types connus pouvant être présents dans le graphique d'objets.

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

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

rootName
String

Nom d'élément racine du contenu.

rootNamespace
String

Espace de noms de l'élément racine.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type qui contient les types pouvant être présents dans le graphique d'objets.

Exemples

L'exemple suivant crée une instance de la classe DataContractSerializer qui spécifie le type à sérialiser ou désérialiser ainsi que le nom et l'espace de noms XML à lire ou écrire dans le document XML. Le code crée également une instance d'une interface IEnumerable<T> pour contenir les types connus utilisés pendant la sérialisation ou la désérialisation.

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

Voir aussi

S’applique à

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié à l'aide de l'élément racine et de l'espace de noms XML spécifiés dans les paramètres de type 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)

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

rootName
XmlDictionaryString

XmlDictionaryString qui contient le nom de l'élément racine du contenu.

rootNamespace
XmlDictionaryString

Classe XmlDictionaryString qui contient l'espace de nom de l'élément racine.

Exemples

L'exemple suivant crée une instance de la classe DataContractSerializer qui spécifie le type à sérialiser ou désérialiser ainsi que le nom et l'espace de noms XML (en tant qu'objets XmlDictionaryString) à lire ou écrire dans le document XML.

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

S’applique à

DataContractSerializer(Type, String, String)

Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié à l'aide de l'élément racine et de l'espace de noms XML fournis.

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)

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

rootName
String

Nom de l'élément XML renfermant le contenu à sérialiser ou désérialiser.

rootNamespace
String

Espace de noms de l'élément XML renfermant le contenu à sérialiser ou désérialiser.

Exemples

L'exemple suivant crée une instance de la classe DataContractSerializer qui spécifie le type à sérialiser ou désérialiser ainsi que le nom et l'espace de noms XML à lire ou écrire dans le document 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

S’applique à

DataContractSerializer(Type, DataContractSerializerSettings)

Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet avec le type et les paramètres spécifiés.

public:
 DataContractSerializer(Type ^ type, System::Runtime::Serialization::DataContractSerializerSettings ^ settings);
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)

Paramètres

type
Type

Type d'instance à sérialiser ou désérialiser.

settings
DataContractSerializerSettings

Paramètres du sérialiseur.

S’applique à

DataContractSerializer(Type, IEnumerable<Type>)

Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié, et une collection de types connus pouvant être présents dans le graphique d'objets.

public:
 DataContractSerializer(Type ^ type, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes);
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))

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type qui contient les types pouvant être présents dans le graphique d'objets.

Exemples

L'exemple suivant crée une instance de la classe DataContractSerializer qui spécifie le type à sérialiser ou désérialiser et une collection des types connus qui peuvent être utilisés dans le graphique d'objets.

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

Voir aussi

S’applique à

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

Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs
Source:
DataContractSerializer.cs

Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également l'élément XML racine et l'espace de noms dans deux paramètres XmlDictionaryString ainsi qu'une liste de types connus pouvant être présents dans le graphique d'objets.

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

Paramètres

type
Type

Type des instances sérialisées ou désérialisées.

rootName
XmlDictionaryString

XmlDictionaryString qui contient le nom de l'élément racine du contenu.

rootNamespace
XmlDictionaryString

Classe XmlDictionaryString qui contient l'espace de nom de l'élément racine.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type qui contient les types connus pouvant être présents dans le graphique d'objets.

Exemples

L'exemple suivant crée une instance de la classe DataContractSerializer qui spécifie le type à sérialiser ou désérialiser ainsi que le nom et l'espace de noms XML (en tant qu'objets XmlDictionaryString) à lire ou écrire dans le document XML. Le code crée également une instance d'une interface IEnumerable<T> pour contenir les types connus utilisés pendant la sérialisation ou la désérialisation.

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

Voir aussi

S’applique à