DataContractSerializer Constructors

Definitie

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 xsi:type tijdens runtime.

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.

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 xsi:type tijdens runtime.

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

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

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

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

Zie ook

Van toepassing op