DataContractSerializer Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Inicializuje novou instanci DataContractSerializer třídy.
Přetížení
| Name | Description |
|---|---|
| DataContractSerializer(Type) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní xml konstrukty k zachování objektových referenčních dat v grafu, náhradní pro vlastní serializaci, parametry XmlDictionaryString , které určují element XML a obor názvů obsahující obsah, a alternativu pro mapování |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní konstrukty XML k zachování dat odkazu na objekt v grafu, náhradní pro vlastní serializaci, element XML a obor názvů obsahující obsah, a alternativu pro mapování |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní xml konstrukty k zachování objektových referenčních dat v grafu, náhradní pro vlastní serializace a parametry XmlDictionaryString , které určují xml element a obor názvů, které obsahují obsah. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní xml konstrukty k zachování objektových referenčních dat v grafu, náhradní pro vlastní serializace a element XML a obor názvů, které obsahují obsah. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní xml konstrukty k zachování objektových referenčních dat v grafu a náhradní pro vlastní serializace. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní konstrukty XML k zachování dat odkazu na objekt v grafu, náhradní pro vlastní serializaci a alternativu pro mapování |
| DataContractSerializer(Type, String, String, IEnumerable<Type>) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje kořenový element XML a obor názvů ve dvou řetězcových parametrech a také seznam známých typů, které mohou být přítomné v objektovém grafu. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu pomocí kořenového elementu XML a oboru názvů určeného prostřednictvím parametrů typu XmlDictionaryString. |
| DataContractSerializer(Type, String, String) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu pomocí zadaného elementu XML kořenového elementu a oboru názvů. |
| DataContractSerializer(Type, DataContractSerializerSettings) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu a nastavení. |
| DataContractSerializer(Type, IEnumerable<Type>) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu a kolekce známých typů, které mohou být přítomné v objektovém grafu. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje kořenový element XML a obor názvů ve dvou XmlDictionaryString parametrech a také seznam známých typů, které mohou být přítomny v objektovém grafu. |
DataContractSerializer(Type)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu.
public:
DataContractSerializer(Type ^ type);
public DataContractSerializer(Type type);
new System.Runtime.Serialization.DataContractSerializer : Type -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type)
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
Příklady
Následující příklad vytvoří instanci DataContractSerializer , která určuje typ serializace nebo deserialize.
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
Platí pro
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní xml konstrukty k zachování objektových referenčních dat v grafu, náhradní pro vlastní serializaci, parametry XmlDictionaryString , které určují element XML a obor názvů obsahující obsah, a alternativu pro mapování xsi:type deklarací za běhu.
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)
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- rootName
- XmlDictionaryString
Xml element, který uzavře obsah k serializaci nebo deserialize.
- rootNamespace
- XmlDictionaryString
Obor názvů elementu XML, který uzavře obsah k serializaci nebo deserializaci.
- knownTypes
- IEnumerable<Type>
Z IEnumerable<T> toho Type , co obsahuje známé typy, které mohou být přítomny v grafu objektu.
- maxItemsInObjectGraph
- Int32
Maximální počet položek v grafu k serializaci nebo deserializaci.
- ignoreExtensionDataObject
- Boolean
trueignorovat data poskytnutá rozšířením typu při serializaci a deserializaci; v opačném případě . false
- preserveObjectReferences
- Boolean
truepoužití nestandardních konstruktorů XML k zachování referenčních dat objektu; v opačném případě . false
- dataContractSurrogate
- IDataContractSurrogate
Implementace procesu IDataContractSurrogate serializace.
- dataContractResolver
- DataContractResolver
Implementace DataContractResolverxsi:type mapování deklarací na datové typy kontraktů.
Platí pro
DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní konstrukty XML k zachování dat odkazu na objekt v grafu, náhradní pro vlastní serializaci, element XML a obor názvů obsahující obsah, a alternativu pro mapování xsi:type deklarací za běhu.
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)
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- rootName
- String
Xml element, který uzavře obsah k serializaci nebo deserialize.
- rootNamespace
- String
Obor názvů elementu XML, který uzavře obsah k serializaci nebo deserializaci.
- knownTypes
- IEnumerable<Type>
Z IEnumerable<T> toho Type , co obsahuje známé typy, které mohou být přítomny v grafu objektu.
- maxItemsInObjectGraph
- Int32
Maximální počet položek v grafu k serializaci nebo deserializaci.
- ignoreExtensionDataObject
- Boolean
trueignorovat data poskytnutá rozšířením typu při serializaci a deserializaci; v opačném případě . false
- preserveObjectReferences
- Boolean
truepoužití nestandardních konstruktorů XML k zachování referenčních dat objektu; v opačném případě . false
- dataContractSurrogate
- IDataContractSurrogate
Implementace procesu IDataContractSurrogate serializace.
- dataContractResolver
- DataContractResolver
Implementace DataContractResolverxsi:type mapování deklarací na datové typy kontraktů.
Platí pro
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní xml konstrukty k zachování objektových referenčních dat v grafu, náhradní pro vlastní serializace a parametry XmlDictionaryString , které určují xml element a obor názvů, které obsahují obsah.
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)
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- rootName
- XmlDictionaryString
Určuje XmlDictionaryString xml element, který uzavře obsah k serializaci nebo deserialize.
- rootNamespace
- XmlDictionaryString
Určuje XmlDictionaryString obor názvů XML kořenového adresáře.
- knownTypes
- IEnumerable<Type>
A IEnumerable<T> of Type that contains the known types that may be present in the object graph.
- maxItemsInObjectGraph
- Int32
Maximální počet položek v grafu k serializaci nebo deserializaci.
- ignoreExtensionDataObject
- Boolean
trueignorovat data poskytnutá rozšířením typu při serializaci a deserializaci; v opačném případě . false
- preserveObjectReferences
- Boolean
truepoužití nestandardních konstruktorů XML k zachování referenčních dat objektu; v opačném případě . false
- dataContractSurrogate
- IDataContractSurrogate
Implementace procesu IDataContractSurrogate serializace.
Výjimky
Počet položek překračuje maximální hodnotu.
Příklady
Následující příklad vytvoří instanci DataContractSerializer , která určuje typ serializace nebo deserializace, kořenový xml element a obor názvů (jako XmlDictionaryString parametry) a instanci IEnumerable<T> obsahující typy použité při deserializaci. Kód také nastaví ignoreExtensionDataObject a parametry na preserveObjectReferences, a určuje implementaci true rozhraní pro zpracování starších typů (typy, které nemají IDataContractSurrogate atribut DataContractAttribute použitý). Další informace najdete v IDataContractSurrogate dokumentaci.
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
Viz také
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- IDataContractSurrogate
Platí pro
DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní xml konstrukty k zachování objektových referenčních dat v grafu, náhradní pro vlastní serializace a element XML a obor názvů, které obsahují obsah.
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)
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- rootName
- String
Xml element, který uzavře obsah k serializaci nebo deserialize.
- rootNamespace
- String
Obor názvů elementu XML, který uzavře obsah k serializaci nebo deserializaci.
- knownTypes
- IEnumerable<Type>
Z IEnumerable<T> toho Type , co obsahuje známé typy, které mohou být přítomny v grafu objektu.
- maxItemsInObjectGraph
- Int32
Maximální počet položek v grafu k serializaci nebo deserializaci.
- ignoreExtensionDataObject
- Boolean
trueignorovat data poskytnutá rozšířením typu při serializaci a deserializaci; v opačném případě . false
- preserveObjectReferences
- Boolean
truepoužití nestandardních konstruktorů XML k zachování referenčních dat objektu; v opačném případě . false
- dataContractSurrogate
- IDataContractSurrogate
Implementace procesu IDataContractSurrogate serializace.
Výjimky
Počet položek překračuje maximální hodnotu.
Příklady
Následující příklad vytvoří instanci DataContractSerializer , která určuje typ serializovat nebo deserializovat, kořenový XML element a obor názvů a instance IEnumerable<T> , která obsahuje typy použité při deserializaci. Kód také nastaví ignoreExtensionDataObject a parametry na preserveObjectReferences, a určuje implementaci true rozhraní pro zpracování starších typů (typy, které nemají IDataContractSurrogate atribut DataContractAttribute použitý). Další informace najdete v IDataContractSurrogate dokumentaci.
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
Viz také
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- KnownTypeAttribute
- IDataContractSurrogate
Platí pro
DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní xml konstrukty k zachování objektových referenčních dat v grafu a náhradní pro vlastní serializace.
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)
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- knownTypes
- IEnumerable<Type>
Z IEnumerable<T> toho Type , co obsahuje známé typy, které mohou být přítomny v grafu objektu.
- maxItemsInObjectGraph
- Int32
Maximální počet položek v grafu k serializaci nebo deserializaci. Výchozí hodnota je hodnota vrácená Int32.MaxValue vlastnost.
- ignoreExtensionDataObject
- Boolean
trueignorovat data poskytnutá rozšířením typu při serializaci a deserializaci; v opačném případě . false
- preserveObjectReferences
- Boolean
truepoužití nestandardních konstruktorů XML k zachování referenčních dat objektu; v opačném případě . false
- dataContractSurrogate
- IDataContractSurrogate
Implementace procesu IDataContractSurrogate serializace.
Výjimky
Počet položek překračuje maximální hodnotu.
Příklady
Následující příklad vytvoří instanci DataContractSerializer , která určuje typ serializace nebo deserializace a instance IEnumerable<T> obsahující známé typy používané během serializace nebo deserializace. Kód také nastaví ignoreExtensionDataObject a parametry na preserveObjectReferences, a určuje implementaci true rozhraní pro zpracování starších typů (typy, které nemají IDataContractSurrogate atribut DataContractAttribute použitý). Další informace najdete v IDataContractSurrogate dokumentaci.
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
Viz také
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- KnownTypeAttribute
- IDataContractSurrogate
Platí pro
DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda použít nestandardní konstrukty XML k zachování dat odkazu na objekt v grafu, náhradní pro vlastní serializaci a alternativu pro mapování xsi:type deklarací za běhu.
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)
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- knownTypes
- IEnumerable<Type>
Z IEnumerable<T> toho Type , co obsahuje známé typy, které mohou být přítomny v grafu objektu.
- maxItemsInObjectGraph
- Int32
Maximální počet položek v grafu k serializaci nebo deserializaci. Výchozí hodnota je hodnota vrácená Int32.MaxValue vlastnost.
- ignoreExtensionDataObject
- Boolean
trueignorovat data poskytnutá rozšířením typu při serializaci a deserializaci; v opačném případě . false
- preserveObjectReferences
- Boolean
truepoužití nestandardních konstruktorů XML k zachování referenčních dat objektu; v opačném případě . false
- dataContractSurrogate
- IDataContractSurrogate
Implementace procesu IDataContractSurrogate serializace.
- dataContractResolver
- DataContractResolver
Implementace DataContractResolverxsi:type mapování deklarací na datové typy kontraktů.
Poznámky
Warning
Tato metoda není dostupná v aplikacích pro Windows Store.
Platí pro
DataContractSerializer(Type, String, String, IEnumerable<Type>)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje kořenový element XML a obor názvů ve dvou řetězcových parametrech a také seznam známých typů, které mohou být přítomné v objektovém grafu.
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))
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- rootName
- String
Název kořenového prvku obsahu.
- rootNamespace
- String
Obor názvů kořenového prvku.
- knownTypes
- IEnumerable<Type>
Z IEnumerable<T>Type toho, co obsahuje typy, které mohou být přítomné v grafu objektu.
Příklady
Následující příklad vytvoří instanci DataContractSerializer , která určuje typ pro serializaci nebo deserializaci, stejně jako název XML a obor názvů pro čtení z dokumentu XML nebo zápis do dokumentu XML. Kód také vytvoří instanci obsahující IEnumerable<T> známé typy používané během serializace nebo deserializace.
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
Viz také
Platí pro
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu pomocí kořenového elementu XML a oboru názvů určeného prostřednictvím parametrů typu 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)
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- rootName
- XmlDictionaryString
Obsahuje XmlDictionaryString název kořenového prvku obsahu.
- rootNamespace
- XmlDictionaryString
Objekt XmlDictionaryString , který obsahuje obor názvů kořenového elementu.
Příklady
Následující příklad vytvoří instanci DataContractSerializer , která určuje typ pro serializaci nebo deserializaci a také název XML a obor názvů (jako XmlDictionaryString objekty) pro čtení z dokumentu XML nebo zápis do dokumentu 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
Platí pro
DataContractSerializer(Type, String, String)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu pomocí zadaného elementu XML kořenového elementu a oboru názvů.
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)
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- rootName
- String
Název xml elementu, který uzavře obsah k serializaci nebo deserialize.
- rootNamespace
- String
Obor názvů elementu XML, který uzavře obsah k serializaci nebo deserializaci.
Příklady
Následující příklad vytvoří instanci DataContractSerializer , která určuje typ pro serializaci nebo deserializaci, stejně jako název XML a obor názvů pro čtení z dokumentu XML nebo zápis do dokumentu 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
Platí pro
DataContractSerializer(Type, DataContractSerializerSettings)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu a nastavení.
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)
Parametry
- type
- Type
Typ instance k serializaci nebo deserializaci.
- settings
- DataContractSerializerSettings
Nastavení serializátoru.
Platí pro
DataContractSerializer(Type, IEnumerable<Type>)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu a kolekce známých typů, které mohou být přítomné v objektovém grafu.
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))
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- knownTypes
- IEnumerable<Type>
Z IEnumerable<T>Type toho, co obsahuje typy, které mohou být přítomné v grafu objektu.
Příklady
Následující příklad vytvoří instanci DataContractSerializer , která určuje typ pro serializaci nebo deserializaci a kolekci známých typů, které lze použít v grafu objektu.
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
Viz také
Platí pro
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje kořenový element XML a obor názvů ve dvou XmlDictionaryString parametrech a také seznam známých typů, které mohou být přítomny v objektovém grafu.
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))
Parametry
- type
- Type
Typ instancí, které jsou serializovány nebo deserializovány.
- rootName
- XmlDictionaryString
Obsahuje XmlDictionaryString název kořenového prvku obsahu.
- rootNamespace
- XmlDictionaryString
Objekt XmlDictionaryString , který obsahuje obor názvů kořenového elementu.
- knownTypes
- IEnumerable<Type>
A IEnumerable<T> of Type that contains the known types that may be present in the object graph.
Příklady
Následující příklad vytvoří instanci DataContractSerializer , která určuje typ pro serializaci nebo deserializaci a také název XML a obor názvů (jako XmlDictionaryString objekty) pro čtení z dokumentu XML nebo zápis do dokumentu XML. Kód také vytvoří instanci obsahující IEnumerable<T> známé typy používané během serializace nebo deserializace.
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