DataContractSerializer Constructeurs

Définition

Initialise une nouvelle instance de la classe DataContractSerializer.

Surcharges

Nom Description
DataContractSerializer(Type)

Initialise une nouvelle instance de la DataContractSerializer classe 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 DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de types connus qui peuvent être présents dans le graphique d’objets, le nombre maximal d’éléments de graphe à 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, une substitution pour la sérialisation personnalisée, les paramètres de ce qui spécifient l’élément XML et l’espace de XmlDictionaryString noms qui contient le contenu, et une alternative pour les déclarations de mappage 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 DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de types connus qui peuvent être présents dans le graphique d’objets, le nombre maximal d’éléments de graphe à 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, une substitution pour la sérialisation personnalisée, l’élément XML et l’espace de noms qui contient le contenu, et une alternative pour les déclarations de mappage xsi:type au moment de l’exécution.

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

Initialise une nouvelle instance de la DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de types connus qui peuvent être présents dans le graphique d’objets, le nombre maximal d’éléments de graphe à 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, une substitution pour la sérialisation personnalisée et les paramètres de ce qui spécifient l’élément XML et l’espace de XmlDictionaryString noms qui contiennent le contenu.

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

Initialise une nouvelle instance de la DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de types connus qui peuvent être présents dans le graphique d’objets, le nombre maximal d’éléments de graphe à 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 graphe, une substitution pour la sérialisation personnalisée et l’élément XML et l’espace de noms qui contiennent le contenu.

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

Initialise une nouvelle instance de la DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de types connus qui peuvent être présents dans le graphique d’objets, le nombre maximal d’éléments de graphe à 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 une substitution pour la sérialisation personnalisée.

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

Initialise une nouvelle instance de la DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de 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, une substitution pour la sérialisation personnalisée et une alternative pour les déclarations de mappage xsi:type au moment de l’exécution.

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

Initialise une nouvelle instance de la DataContractSerializer classe 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 de types connus qui peuvent être présents dans le graphe d’objets.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

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

DataContractSerializer(Type, String, String)

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

DataContractSerializer(Type, DataContractSerializerSettings)

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

DataContractSerializer(Type, IEnumerable<Type>)

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

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

Initialise une nouvelle instance de la DataContractSerializer classe 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 XmlDictionaryString paramètres, ainsi qu’une liste de types connus qui peuvent être présents dans le graphique d’objets.

DataContractSerializer(Type)

Initialise une nouvelle instance de la DataContractSerializer classe 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 du DataContractSerializer 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 DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de types connus qui peuvent être présents dans le graphique d’objets, le nombre maximal d’éléments de graphe à 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, une substitution pour la sérialisation personnalisée, les paramètres de ce qui spécifient l’élément XML et l’espace de XmlDictionaryString noms qui contient le contenu, et une alternative pour les déclarations de mappage 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 qui entoure le contenu à sérialiser ou désérialiser.

rootNamespace
XmlDictionaryString

Espace de noms de l’élément XML qui entoure le contenu à sérialiser ou désérialiser.

knownTypes
IEnumerable<Type>

Qui IEnumerable<T>Type contient les types connus qui peuvent être présents dans le graphe d’objets.

maxItemsInObjectGraph
Int32

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

ignoreExtensionDataObject
Boolean

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

preserveObjectReferences
Boolean

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

dataContractSurrogate
IDataContractSurrogate

Implémentation du processus de IDataContractSurrogate sérialisation.

dataContractResolver
DataContractResolver

Implémentation des DataContractResolver déclarations pour mapper xsi:type les déclarations aux 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 DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de types connus qui peuvent être présents dans le graphique d’objets, le nombre maximal d’éléments de graphe à 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, une substitution pour la sérialisation personnalisée, l’élément XML et l’espace de noms qui contient le contenu, et une alternative pour les déclarations de mappage 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 qui entoure le contenu à sérialiser ou désérialiser.

rootNamespace
String

Espace de noms de l’élément XML qui entoure le contenu à sérialiser ou désérialiser.

knownTypes
IEnumerable<Type>

Qui IEnumerable<T>Type contient les types connus qui peuvent être présents dans le graphe d’objets.

maxItemsInObjectGraph
Int32

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

ignoreExtensionDataObject
Boolean

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

preserveObjectReferences
Boolean

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

dataContractSurrogate
IDataContractSurrogate

Implémentation du processus de IDataContractSurrogate sérialisation.

dataContractResolver
DataContractResolver

Implémentation des DataContractResolver déclarations pour mapper xsi:type les déclarations aux types de contrat de données.

S’applique à

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

Initialise une nouvelle instance de la DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de types connus qui peuvent être présents dans le graphique d’objets, le nombre maximal d’éléments de graphe à 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, une substitution pour la sérialisation personnalisée et les paramètres de ce qui spécifient l’élément XML et l’espace de XmlDictionaryString noms 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

Qui XmlDictionaryString spécifie l’élément XML qui entoure le contenu à sérialiser ou désérialiser.

rootNamespace
XmlDictionaryString

Qui XmlDictionaryString spécifie l’espace de noms XML de la racine.

knownTypes
IEnumerable<Type>

Qui IEnumerable<T>Type contient les types connus qui peuvent être présents dans le graphe d’objets.

maxItemsInObjectGraph
Int32

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

ignoreExtensionDataObject
Boolean

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

preserveObjectReferences
Boolean

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

dataContractSurrogate
IDataContractSurrogate

Implémentation du processus de IDataContractSurrogate sérialisation.

Exceptions

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

Exemples

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

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 DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de types connus qui peuvent être présents dans le graphique d’objets, le nombre maximal d’éléments de graphe à 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 graphe, une substitution pour la sérialisation personnalisée et l’élément XML et l’espace de noms qui contiennent 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 qui entoure le contenu à sérialiser ou désérialiser.

rootNamespace
String

Espace de noms de l’élément XML qui entoure le contenu à sérialiser ou désérialiser.

knownTypes
IEnumerable<Type>

Qui IEnumerable<T>Type contient les types connus qui peuvent être présents dans le graphe d’objets.

maxItemsInObjectGraph
Int32

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

ignoreExtensionDataObject
Boolean

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

preserveObjectReferences
Boolean

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

dataContractSurrogate
IDataContractSurrogate

Implémentation du processus de IDataContractSurrogate sérialisation.

Exceptions

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

Exemples

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

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 DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de types connus qui peuvent être présents dans le graphique d’objets, le nombre maximal d’éléments de graphe à 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 une substitution 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>

Qui IEnumerable<T>Type contient les types connus qui peuvent être présents dans le graphe d’objets.

maxItemsInObjectGraph
Int32

Nombre maximal d’éléments dans le graphique à sérialiser ou désérialiser. La valeur par défaut est renvoyé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 de la désérialisation ; sinon, false.

preserveObjectReferences
Boolean

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

dataContractSurrogate
IDataContractSurrogate

Implémentation du processus de IDataContractSurrogate sérialisation.

Exceptions

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

Exemples

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

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 DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également une liste de 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, une substitution pour la sérialisation personnalisée et une alternative pour les déclarations de mappage 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>

Qui IEnumerable<T>Type contient les types connus qui peuvent être présents dans le graphe d’objets.

maxItemsInObjectGraph
Int32

Nombre maximal d’éléments dans le graphique à sérialiser ou désérialiser. La valeur par défaut est renvoyé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 de la désérialisation ; sinon, false.

preserveObjectReferences
Boolean

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

dataContractSurrogate
IDataContractSurrogate

Implémentation du processus de IDataContractSurrogate sérialisation.

dataContractResolver
DataContractResolver

Implémentation des DataContractResolver déclarations pour mapper xsi:type les déclarations aux types de contrat de données.

Remarques

Warning

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

S’applique à

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

Initialise une nouvelle instance de la DataContractSerializer classe 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 de types connus qui peuvent être présents dans le graphe 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);
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 de l’élément racine du contenu.

rootNamespace
String

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

knownTypes
IEnumerable<Type>

Qui IEnumerable<T>Type contient les types qui peuvent être présents dans le graphique d’objet.

Exemples

L’exemple suivant crée une instance du DataContractSerializer 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’un IEnumerable<T> pour contenir les types connus utilisés lors de la sérialisation ou de 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)

Initialise une nouvelle instance de la DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié à l’aide de l’élément racine XML et de l’espace de noms spécifiés par le biais des 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

Qui XmlDictionaryString contient le nom de l’élément racine du contenu.

rootNamespace
XmlDictionaryString

Qui XmlDictionaryString contient l’espace de noms de l’élément racine.

Exemples

L’exemple suivant crée une instance du DataContractSerializer 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)

Initialise une nouvelle instance de la DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié à l’aide de l’élément racine XML et de l’espace de noms 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 qui entoure le contenu à sérialiser ou désérialiser.

rootNamespace
String

Espace de noms de l’élément XML qui entoure le contenu à sérialiser ou désérialiser.

Exemples

L’exemple suivant crée une instance du DataContractSerializer 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)

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

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 de l’instance à sérialiser ou désérialiser.

settings
DataContractSerializerSettings

Paramètres du sérialiseur.

S’applique à

DataContractSerializer(Type, IEnumerable<Type>)

Initialise une nouvelle instance de la DataContractSerializer classe pour sérialiser ou désérialiser un objet du type spécifié et une collection de types connus qui peuvent ê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);
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>

Qui IEnumerable<T>Type contient les types qui peuvent être présents dans le graphique d’objet.

Exemples

L’exemple suivant crée une instance du DataContractSerializer type qui spécifie le type à sérialiser ou désérialiser et une collection de 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>)

Initialise une nouvelle instance de la DataContractSerializer classe 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 XmlDictionaryString paramètres, ainsi qu’une liste de types connus qui peuvent ê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);
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

Qui XmlDictionaryString contient le nom de l’élément racine du contenu.

rootNamespace
XmlDictionaryString

Qui XmlDictionaryString contient l’espace de noms de l’élément racine.

knownTypes
IEnumerable<Type>

Qui IEnumerable<T>Type contient les types connus qui peuvent être présents dans le graphe d’objets.

Exemples

L’exemple suivant crée une instance du DataContractSerializer 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’un IEnumerable<T> pour contenir les types connus utilisés lors de la sérialisation ou de 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 à