DataContractSerializer Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse.
Overloads
| Name | Description |
|---|---|
| DataContractSerializer(Type) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode wordt ook een lijst met bekende typen opgegeven die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal grafiekitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, ongeacht of er niet-standaard XML-constructies moeten worden gebruikt om objectverwijzingsgegevens in de grafiek te behouden, een surrogaat voor aangepaste serialisatie, parameters die XmlDictionaryString het XML-element en de naamruimte opgeven die de inhoud bevat, en een alternatief voor toewijzingsdeclaraties |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode wordt ook een lijst opgegeven met bekende typen die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal graafitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, of er niet-standaard XML-constructies moeten worden gebruikt om objectverwijzingsgegevens in de grafiek te behouden, een surrogaat voor aangepaste serialisatie, het XML-element en de naamruimte die de inhoud bevat, en een alternatief voor toewijzingsdeclaraties |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode geeft u ook een lijst met bekende typen op die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal grafiekitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, of u niet-standaard XML-constructies wilt gebruiken om objectverwijzingsgegevens in de grafiek te behouden, een surrogaat voor aangepaste serialisatie en parameters van XmlDictionaryString die het XML-element en de naamruimte opgeven die de inhoud bevatten. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode geeft u ook een lijst met bekende typen op die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal grafiekitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, of u niet-standaard XML-constructies wilt gebruiken om objectverwijzingsgegevens in de grafiek te behouden, een surrogaat voor aangepaste serialisatie en het XML-element en de naamruimte die de inhoud bevatten. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Deze methode geeft ook een lijst met bekende typen op die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal grafiekitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, of niet-standaard XML-constructies moeten worden gebruikt om objectverwijzingsgegevens in de grafiek te behouden en een surrogaat voor aangepaste serialisatie. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode geeft u ook een lijst met bekende typen op die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal grafiekitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, of u niet-standaard XML-constructies wilt gebruiken om objectverwijzingsgegevens in de grafiek te behouden, een surrogaat voor aangepaste serialisatie en een alternatief voor toewijzingsdeclaraties |
| DataContractSerializer(Type, String, String, IEnumerable<Type>) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode worden ook het XML-hoofdelement en de naamruimte in twee tekenreeksparameters opgegeven, evenals een lijst met bekende typen die mogelijk aanwezig zijn in de objectgrafiek. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren met behulp van het XML-hoofdelement en de naamruimte die is opgegeven via de parameters van het type XmlDictionaryString. |
| DataContractSerializer(Type, String, String) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren met behulp van het opgegeven XML-hoofdelement en de naamruimte. |
| DataContractSerializer(Type, DataContractSerializerSettings) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type en deserialiseren te serialiseren of deserialiseren. |
| DataContractSerializer(Type, IEnumerable<Type>) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren en een verzameling bekende typen die mogelijk aanwezig zijn in de objectgrafiek. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>) |
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode worden ook het XML-hoofdelement en de naamruimte in twee XmlDictionaryString parameters opgegeven, evenals een lijst met bekende typen die mogelijk aanwezig zijn in de objectgrafiek. |
DataContractSerializer(Type)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren.
public:
DataContractSerializer(Type ^ type);
public DataContractSerializer(Type type);
new System.Runtime.Serialization.DataContractSerializer : Type -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type)
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het DataContractSerializer type dat het type aangeeft dat moet worden geserialiseerd of gedeserialiseerd.
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
Van toepassing op
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode wordt ook een lijst met bekende typen opgegeven die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal grafiekitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, ongeacht of er niet-standaard XML-constructies moeten worden gebruikt om objectverwijzingsgegevens in de grafiek te behouden, een surrogaat voor aangepaste serialisatie, parameters die XmlDictionaryString het XML-element en de naamruimte opgeven die de inhoud bevat, en een alternatief voor toewijzingsdeclaraties xsi:type tijdens runtime.
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)
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- rootName
- XmlDictionaryString
Het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- rootNamespace
- XmlDictionaryString
De naamruimte van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- knownTypes
- IEnumerable<Type>
Een IEnumerable<T> van Type de bekende typen die mogelijk aanwezig zijn in de objectgrafiek.
- maxItemsInObjectGraph
- Int32
Het maximum aantal items in de grafiek dat moet worden geserialiseerd of gedeserialiseerd.
- ignoreExtensionDataObject
- Boolean
true om de gegevens die door een uitbreiding van het type worden geleverd, te negeren bij serialisatie en deserialisatie; anders, false.
- preserveObjectReferences
- Boolean
true niet-standaard XML-constructies gebruiken om objectverwijzingsgegevens te behouden; anders, false.
- dataContractSurrogate
- IDataContractSurrogate
Een implementatie van het IDataContractSurrogate om het serialisatieproces aan te passen.
- dataContractResolver
- DataContractResolver
Een implementatie van de DataContractResolver om declaraties toe te wijzen xsi:type aan gegevenscontracttypen.
Van toepassing op
DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode wordt ook een lijst opgegeven met bekende typen die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal graafitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, of er niet-standaard XML-constructies moeten worden gebruikt om objectverwijzingsgegevens in de grafiek te behouden, een surrogaat voor aangepaste serialisatie, het XML-element en de naamruimte die de inhoud bevat, en een alternatief voor toewijzingsdeclaraties xsi:type tijdens runtime.
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)
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- rootName
- String
Het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- rootNamespace
- String
De naamruimte van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- knownTypes
- IEnumerable<Type>
Een IEnumerable<T> van Type de bekende typen die mogelijk aanwezig zijn in de objectgrafiek.
- maxItemsInObjectGraph
- Int32
Het maximum aantal items in de grafiek dat moet worden geserialiseerd of gedeserialiseerd.
- ignoreExtensionDataObject
- Boolean
true om de gegevens die door een uitbreiding van het type worden geleverd, te negeren bij serialisatie en deserialisatie; anders, false.
- preserveObjectReferences
- Boolean
true niet-standaard XML-constructies gebruiken om objectverwijzingsgegevens te behouden; anders, false.
- dataContractSurrogate
- IDataContractSurrogate
Een implementatie van het IDataContractSurrogate om het serialisatieproces aan te passen.
- dataContractResolver
- DataContractResolver
Een implementatie van de DataContractResolver om declaraties toe te wijzen xsi:type aan gegevenscontracttypen.
Van toepassing op
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode geeft u ook een lijst met bekende typen op die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal grafiekitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, of u niet-standaard XML-constructies wilt gebruiken om objectverwijzingsgegevens in de grafiek te behouden, een surrogaat voor aangepaste serialisatie en parameters van XmlDictionaryString die het XML-element en de naamruimte opgeven die de inhoud bevatten.
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)
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- rootName
- XmlDictionaryString
Hiermee XmlDictionaryString geeft u het XML-element op waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- rootNamespace
- XmlDictionaryString
Hiermee XmlDictionaryString geeft u de XML-naamruimte van de hoofdmap op.
- knownTypes
- IEnumerable<Type>
Een IEnumerable<T> van Type de bekende typen die mogelijk aanwezig zijn in de objectgrafiek.
- maxItemsInObjectGraph
- Int32
Het maximum aantal items in de grafiek dat moet worden geserialiseerd of gedeserialiseerd.
- ignoreExtensionDataObject
- Boolean
true om de gegevens die door een uitbreiding van het type worden geleverd, te negeren bij serialisatie en deserialisatie; anders, false.
- preserveObjectReferences
- Boolean
true niet-standaard XML-constructies gebruiken om objectverwijzingsgegevens te behouden; anders, false.
- dataContractSurrogate
- IDataContractSurrogate
Een implementatie van het IDataContractSurrogate om het serialisatieproces aan te passen.
Uitzonderingen
Het aantal items overschrijdt de maximumwaarde.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het DataContractSerializer type dat het type aangeeft dat moet worden geserialiseerd of gedeserialiseerd, het XML-hoofdelement en de naamruimte (als XmlDictionaryString parameters) en een exemplaar van een IEnumerable<T> exemplaar dat de typen bevat die tijdens deserialisatie worden gebruikt. De code stelt ook de ignoreExtensionDataObject en preserveObjectReferences parameters truein op en geeft een implementatie van de interface op voor het IDataContractSurrogate verwerken van verouderde typen (typen waarop het DataContractAttribute kenmerk niet is toegepast). Zie de IDataContractSurrogate documentatie voor meer informatie.
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
Zie ook
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- IDataContractSurrogate
Van toepassing op
DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode geeft u ook een lijst met bekende typen op die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal grafiekitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, of u niet-standaard XML-constructies wilt gebruiken om objectverwijzingsgegevens in de grafiek te behouden, een surrogaat voor aangepaste serialisatie en het XML-element en de naamruimte die de inhoud bevatten.
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)
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- rootName
- String
Het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- rootNamespace
- String
De naamruimte van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- knownTypes
- IEnumerable<Type>
Een IEnumerable<T> van Type de bekende typen die mogelijk aanwezig zijn in de objectgrafiek.
- maxItemsInObjectGraph
- Int32
Het maximum aantal items in de grafiek dat moet worden geserialiseerd of gedeserialiseerd.
- ignoreExtensionDataObject
- Boolean
true om de gegevens die door een uitbreiding van het type worden geleverd, te negeren bij serialisatie en deserialisatie; anders, false.
- preserveObjectReferences
- Boolean
true niet-standaard XML-constructies gebruiken om objectverwijzingsgegevens te behouden; anders, false.
- dataContractSurrogate
- IDataContractSurrogate
Een implementatie van het IDataContractSurrogate om het serialisatieproces aan te passen.
Uitzonderingen
Het aantal items overschrijdt de maximumwaarde.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het DataContractSerializer type dat het type aangeeft dat moet worden geserialiseerd of gedeserialaliseerd, het XML-hoofdelement en de naamruimte en een exemplaar van een IEnumerable<T> exemplaar dat de typen bevat die tijdens deserialisatie worden gebruikt. De code stelt ook de ignoreExtensionDataObject en preserveObjectReferences parameters truein op en geeft een implementatie van de interface op voor het IDataContractSurrogate verwerken van verouderde typen (typen waarop het DataContractAttribute kenmerk niet is toegepast). Zie de IDataContractSurrogate documentatie voor meer informatie.
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
Zie ook
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- KnownTypeAttribute
- IDataContractSurrogate
Van toepassing op
DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Deze methode geeft ook een lijst met bekende typen op die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal grafiekitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, of niet-standaard XML-constructies moeten worden gebruikt om objectverwijzingsgegevens in de grafiek te behouden en een surrogaat voor aangepaste serialisatie.
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)
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- knownTypes
- IEnumerable<Type>
Een IEnumerable<T> van Type de bekende typen die mogelijk aanwezig zijn in de objectgrafiek.
- maxItemsInObjectGraph
- Int32
Het maximum aantal items in de grafiek dat moet worden geserialiseerd of gedeserialiseerd. De standaardwaarde is de waarde die wordt geretourneerd door de eigenschap Int32.MaxValue .
- ignoreExtensionDataObject
- Boolean
true om de gegevens die door een uitbreiding van het type worden geleverd, te negeren bij serialisatie en deserialisatie; anders, false.
- preserveObjectReferences
- Boolean
true niet-standaard XML-constructies gebruiken om objectverwijzingsgegevens te behouden; anders, false.
- dataContractSurrogate
- IDataContractSurrogate
Een implementatie van het IDataContractSurrogate om het serialisatieproces aan te passen.
Uitzonderingen
Het aantal items overschrijdt de maximumwaarde.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het DataContractSerializer type dat het type aangeeft dat moet worden geserialiseerd of gedeserialiseerd en een exemplaar van een IEnumerable<T> exemplaar dat de bekende typen bevat die worden gebruikt tijdens serialisatie of deserialisatie. De code stelt ook de ignoreExtensionDataObject en preserveObjectReferences parameters truein op en geeft een implementatie van de interface op voor het IDataContractSurrogate verwerken van verouderde typen (typen waarop het DataContractAttribute kenmerk niet is toegepast). Zie de IDataContractSurrogate documentatie voor meer informatie.
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
Zie ook
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- KnownTypeAttribute
- IDataContractSurrogate
Van toepassing op
DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode geeft u ook een lijst met bekende typen op die aanwezig kunnen zijn in de objectgrafiek, het maximum aantal grafiekitems dat moet worden geserialiseerd, parameters om onverwachte gegevens te negeren, of u niet-standaard XML-constructies wilt gebruiken om objectverwijzingsgegevens in de grafiek te behouden, een surrogaat voor aangepaste serialisatie en een alternatief voor toewijzingsdeclaraties xsi:type tijdens runtime.
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)
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- knownTypes
- IEnumerable<Type>
Een IEnumerable<T> van Type de bekende typen die mogelijk aanwezig zijn in de objectgrafiek.
- maxItemsInObjectGraph
- Int32
Het maximum aantal items in de grafiek dat moet worden geserialiseerd of gedeserialiseerd. De standaardwaarde is de waarde die wordt geretourneerd door de eigenschap Int32.MaxValue .
- ignoreExtensionDataObject
- Boolean
true om de gegevens die door een uitbreiding van het type worden geleverd, te negeren bij serialisatie en deserialisatie; anders, false.
- preserveObjectReferences
- Boolean
true niet-standaard XML-constructies gebruiken om objectverwijzingsgegevens te behouden; anders, false.
- dataContractSurrogate
- IDataContractSurrogate
Een implementatie van het IDataContractSurrogate om het serialisatieproces aan te passen.
- dataContractResolver
- DataContractResolver
Een implementatie van de DataContractResolver om declaraties toe te wijzen xsi:type aan gegevenscontracttypen.
Opmerkingen
Waarschuwing
Deze methode is niet beschikbaar in Windows Store-apps.
Van toepassing op
DataContractSerializer(Type, String, String, IEnumerable<Type>)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode worden ook het XML-hoofdelement en de naamruimte in twee tekenreeksparameters opgegeven, evenals een lijst met bekende typen die mogelijk aanwezig zijn in de objectgrafiek.
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))
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- rootName
- String
De naam van het hoofdelement van de inhoud.
- rootNamespace
- String
De naamruimte van het hoofdelement.
- knownTypes
- IEnumerable<Type>
Een IEnumerable<T> van Type de typen die mogelijk aanwezig zijn in de objectgrafiek.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het DataContractSerializer type waarmee het type wordt opgegeven dat moet worden geserialiseerd of gedeserialiseerd, evenals de XML-naam en naamruimte waaruit u wilt lezen of schrijven naar het XML-document. Met de code wordt ook een exemplaar gemaakt van een IEnumerable<T> exemplaar dat de bekende typen bevat die tijdens de serialisatie of deserialisatie worden gebruikt.
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
Zie ook
Van toepassing op
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren met behulp van het XML-hoofdelement en de naamruimte die is opgegeven via de parameters van het 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)
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- rootName
- XmlDictionaryString
Een XmlDictionaryString met de naam van het hoofdelement van de inhoud.
- rootNamespace
- XmlDictionaryString
Een XmlDictionaryString met de naamruimte van het hoofdelement.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het DataContractSerializer type waarmee het type wordt opgegeven dat moet worden geserialiseerd of gedeserialiseerd, evenals de XML-naam en naamruimte (als XmlDictionaryString objecten) waaruit u wilt lezen of schrijven naar het XML-document.
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
Van toepassing op
DataContractSerializer(Type, String, String)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren met behulp van het opgegeven XML-hoofdelement en de naamruimte.
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)
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- rootName
- String
De naam van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- rootNamespace
- String
De naamruimte van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het DataContractSerializer type waarmee het type wordt opgegeven dat moet worden geserialiseerd of gedeserialiseerd, evenals de XML-naam en naamruimte waaruit u wilt lezen of schrijven naar het XML-document.
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
Van toepassing op
DataContractSerializer(Type, DataContractSerializerSettings)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type en deserialiseren te serialiseren of deserialiseren.
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)
Parameters
- type
- Type
Het type exemplaar dat moet worden geserialiseerd of gedeserialiseerd.
- settings
- DataContractSerializerSettings
De serialisatie-instellingen.
Van toepassing op
DataContractSerializer(Type, IEnumerable<Type>)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren en een verzameling bekende typen die mogelijk aanwezig zijn in de objectgrafiek.
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))
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- knownTypes
- IEnumerable<Type>
Een IEnumerable<T> van Type de typen die mogelijk aanwezig zijn in de objectgrafiek.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het DataContractSerializer type waarmee wordt opgegeven welk type moet worden geserialiseerd of gedeserialiseerd en een verzameling bekende typen die in de objectgrafiek kunnen worden gebruikt.
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
Zie ook
Van toepassing op
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)
Initialiseert een nieuw exemplaar van de DataContractSerializer klasse om een object van het opgegeven type te serialiseren of deserialiseren. Met deze methode worden ook het XML-hoofdelement en de naamruimte in twee XmlDictionaryString parameters opgegeven, evenals een lijst met bekende typen die mogelijk aanwezig zijn in de objectgrafiek.
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))
Parameters
- type
- Type
Het type exemplaren dat wordt geserialiseerd of gedeserialiseerd.
- rootName
- XmlDictionaryString
Een XmlDictionaryString met de naam van het hoofdelement van de inhoud.
- rootNamespace
- XmlDictionaryString
Een XmlDictionaryString met de naamruimte van het hoofdelement.
- knownTypes
- IEnumerable<Type>
Een IEnumerable<T> van Type de bekende typen die mogelijk aanwezig zijn in de objectgrafiek.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het DataContractSerializer type waarmee het type wordt opgegeven dat moet worden geserialiseerd of gedeserialiseerd, evenals de XML-naam en naamruimte (als XmlDictionaryString objecten) waaruit u wilt lezen of schrijven naar het XML-document. Met de code wordt ook een exemplaar gemaakt van een IEnumerable<T> exemplaar dat de bekende typen bevat die tijdens de serialisatie of deserialisatie worden gebruikt.
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