DataContractSerializer Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 |
| 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 |
| 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 |
| 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
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- IDataContractSurrogate
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
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- KnownTypeAttribute
- IDataContractSurrogate
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
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- KnownTypeAttribute
- IDataContractSurrogate
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