DataContractSerializer Constructores

Definición

Inicializa una nueva instancia de la clase DataContractSerializer.

Sobrecargas

Nombre Description
DataContractSerializer(Type)

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado.

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo para serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada, parámetros de que especifican el elemento XML y el espacio de XmlDictionaryString nombres que contiene el contenido, y una alternativa para las declaraciones de asignación xsi:type en tiempo de ejecución.

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada, el elemento XML y el espacio de nombres que contiene el contenido, y una alternativa para las declaraciones de asignación xsi:type en tiempo de ejecución.

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo para serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada y parámetros de que especifican el elemento XML y el espacio de XmlDictionaryString nombres que contienen el contenido.

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, parámetros para omitir datos inesperados, si usar construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada y el elemento XML y el espacio de nombres que contienen el contenido.

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo y un suplente para la serialización personalizada.

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, los parámetros para omitir datos inesperados, si usar construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada y una alternativa para las declaraciones de asignación xsi:type en tiempo de ejecución.

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica el elemento XML raíz y el espacio de nombres en dos parámetros de cadena, así como una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado mediante el elemento raíz XML y el espacio de nombres especificados a través de los parámetros de tipo XmlDictionaryString.

DataContractSerializer(Type, String, String)

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado mediante el elemento raíz y el espacio de nombres XML proporcionados.

DataContractSerializer(Type, DataContractSerializerSettings)

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo y la configuración especificados.

DataContractSerializer(Type, IEnumerable<Type>)

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado y una colección de tipos conocidos que pueden estar presentes en el gráfico de objetos.

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica el elemento XML raíz y el espacio de nombres en dos XmlDictionaryString parámetros, así como una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos.

DataContractSerializer(Type)

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado.

public:
 DataContractSerializer(Type ^ type);
public DataContractSerializer(Type type);
new System.Runtime.Serialization.DataContractSerializer : Type -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type)

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

Ejemplos

En el ejemplo siguiente se crea una instancia de DataContractSerializer que especifica el tipo que se va a serializar o deserializar.

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

Se aplica a

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo para serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada, parámetros de que especifican el elemento XML y el espacio de XmlDictionaryString nombres que contiene el contenido, y una alternativa para las declaraciones de asignación xsi:type en tiempo de ejecución.

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)

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

rootName
XmlDictionaryString

Elemento XML que incluye el contenido que se va a serializar o deserializar.

rootNamespace
XmlDictionaryString

Espacio de nombres del elemento XML que incluye el contenido que se va a serializar o deserializar.

knownTypes
IEnumerable<Type>

de IEnumerable<T>Type que contiene los tipos conocidos que pueden estar presentes en el gráfico de objetos.

maxItemsInObjectGraph
Int32

Número máximo de elementos del gráfico que se van a serializar o deserializar.

ignoreExtensionDataObject
Boolean

true para pasar por alto los datos proporcionados por una extensión del tipo tras la serialización y deserialización; de lo contrario, false.

preserveObjectReferences
Boolean

true para usar construcciones XML no estándar para conservar los datos de referencia de objetos; de lo contrario, false.

dataContractSurrogate
IDataContractSurrogate

Implementación de IDataContractSurrogate para personalizar el proceso de serialización.

dataContractResolver
DataContractResolver

Implementación de para DataContractResolver asignar xsi:type declaraciones a tipos de contrato de datos.

Se aplica a

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada, el elemento XML y el espacio de nombres que contiene el contenido, y una alternativa para las declaraciones de asignación xsi:type en tiempo de ejecución.

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)

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

rootName
String

Elemento XML que incluye el contenido que se va a serializar o deserializar.

rootNamespace
String

Espacio de nombres del elemento XML que incluye el contenido que se va a serializar o deserializar.

knownTypes
IEnumerable<Type>

de IEnumerable<T>Type que contiene los tipos conocidos que pueden estar presentes en el gráfico de objetos.

maxItemsInObjectGraph
Int32

Número máximo de elementos del gráfico que se van a serializar o deserializar.

ignoreExtensionDataObject
Boolean

true para pasar por alto los datos proporcionados por una extensión del tipo tras la serialización y deserialización; de lo contrario, false.

preserveObjectReferences
Boolean

true para usar construcciones XML no estándar para conservar los datos de referencia de objetos; de lo contrario, false.

dataContractSurrogate
IDataContractSurrogate

Implementación de IDataContractSurrogate para personalizar el proceso de serialización.

dataContractResolver
DataContractResolver

Implementación de para DataContractResolver asignar xsi:type declaraciones a tipos de contrato de datos.

Se aplica a

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo para serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada y parámetros de que especifican el elemento XML y el espacio de XmlDictionaryString nombres que contienen el contenido.

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)

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

rootName
XmlDictionaryString

XmlDictionaryString que especifica el elemento XML que incluye el contenido que se va a serializar o deserializar.

rootNamespace
XmlDictionaryString

XmlDictionaryString que especifica el espacio de nombres XML de la raíz.

knownTypes
IEnumerable<Type>

de IEnumerable<T>Type que contiene los tipos conocidos que pueden estar presentes en el gráfico de objetos.

maxItemsInObjectGraph
Int32

Número máximo de elementos del gráfico que se van a serializar o deserializar.

ignoreExtensionDataObject
Boolean

true para pasar por alto los datos proporcionados por una extensión del tipo tras la serialización y deserialización; de lo contrario, false.

preserveObjectReferences
Boolean

true para usar construcciones XML no estándar para conservar los datos de referencia de objetos; de lo contrario, false.

dataContractSurrogate
IDataContractSurrogate

Implementación de IDataContractSurrogate para personalizar el proceso de serialización.

Excepciones

El número de elementos supera el valor máximo.

Ejemplos

En el ejemplo siguiente se crea una instancia de DataContractSerializer que especifica el tipo que se va a serializar o deserializar, el elemento XML raíz y el espacio de nombres (como XmlDictionaryString parámetros) y una instancia de que IEnumerable<T> contiene los tipos usados durante la deserialización. El código también establece los ignoreExtensionDataObject parámetros y preserveObjectReferences en y especifica una implementación de la IDataContractSurrogate interfaz para controlar los tipos heredados true(tipos que no tienen aplicado el DataContractAttribute atributo). Para obtener más información, consulte la IDataContractSurrogate documentación.

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

Consulte también

Se aplica a

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, parámetros para omitir datos inesperados, si usar construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada y el elemento XML y el espacio de nombres que contienen el contenido.

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)

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

rootName
String

Elemento XML que incluye el contenido que se va a serializar o deserializar.

rootNamespace
String

Espacio de nombres del elemento XML que incluye el contenido que se va a serializar o deserializar.

knownTypes
IEnumerable<Type>

de IEnumerable<T>Type que contiene los tipos conocidos que pueden estar presentes en el gráfico de objetos.

maxItemsInObjectGraph
Int32

Número máximo de elementos del gráfico que se van a serializar o deserializar.

ignoreExtensionDataObject
Boolean

true para pasar por alto los datos proporcionados por una extensión del tipo tras la serialización y deserialización; de lo contrario, false.

preserveObjectReferences
Boolean

true para usar construcciones XML no estándar para conservar los datos de referencia de objetos; de lo contrario, false.

dataContractSurrogate
IDataContractSurrogate

Implementación de IDataContractSurrogate para personalizar el proceso de serialización.

Excepciones

El número de elementos supera el valor máximo.

Ejemplos

En el ejemplo siguiente se crea una instancia de DataContractSerializer que especifica el tipo que se va a serializar o deserializar, el elemento XML raíz y el espacio de nombres, y una instancia de que IEnumerable<T> contiene los tipos usados durante la deserialización. El código también establece los ignoreExtensionDataObject parámetros y preserveObjectReferences en y especifica una implementación de la IDataContractSurrogate interfaz para controlar los tipos heredados true(tipos que no tienen aplicado el DataContractAttribute atributo). Para obtener más información, consulte la IDataContractSurrogate documentación.

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

Consulte también

Se aplica a

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, parámetros para omitir datos inesperados, si se usan construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo y un suplente para la serialización personalizada.

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)

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

knownTypes
IEnumerable<Type>

de IEnumerable<T>Type que contiene los tipos conocidos que pueden estar presentes en el gráfico de objetos.

maxItemsInObjectGraph
Int32

Número máximo de elementos del gráfico que se van a serializar o deserializar. El valor predeterminado es el valor devuelto por la propiedad Int32.MaxValue .

ignoreExtensionDataObject
Boolean

true para pasar por alto los datos proporcionados por una extensión del tipo tras la serialización y deserialización; de lo contrario, false.

preserveObjectReferences
Boolean

true para usar construcciones XML no estándar para conservar los datos de referencia de objetos; de lo contrario, false.

dataContractSurrogate
IDataContractSurrogate

Implementación de IDataContractSurrogate para personalizar el proceso de serialización.

Excepciones

El número de elementos supera el valor máximo.

Ejemplos

En el ejemplo siguiente se crea una instancia de DataContractSerializer que especifica el tipo que se va a serializar o deserializar y una instancia de para IEnumerable<T> contener los tipos conocidos usados durante la serialización o deserialización. El código también establece los ignoreExtensionDataObject parámetros y preserveObjectReferences en y especifica una implementación de la IDataContractSurrogate interfaz para controlar los tipos heredados true(tipos que no tienen aplicado el DataContractAttribute atributo). Para obtener más información, consulte la IDataContractSurrogate documentación.

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

Consulte también

Se aplica a

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos, el número máximo de elementos de grafo que se van a serializar, los parámetros para omitir datos inesperados, si usar construcciones XML no estándar para conservar los datos de referencia de objetos en el grafo, un suplente para la serialización personalizada y una alternativa para las declaraciones de asignación xsi:type en tiempo de ejecución.

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)

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

knownTypes
IEnumerable<Type>

de IEnumerable<T>Type que contiene los tipos conocidos que pueden estar presentes en el gráfico de objetos.

maxItemsInObjectGraph
Int32

Número máximo de elementos del gráfico que se van a serializar o deserializar. El valor predeterminado es el valor devuelto por la propiedad Int32.MaxValue .

ignoreExtensionDataObject
Boolean

true para pasar por alto los datos proporcionados por una extensión del tipo tras la serialización y deserialización; de lo contrario, false.

preserveObjectReferences
Boolean

true para usar construcciones XML no estándar para conservar los datos de referencia de objetos; de lo contrario, false.

dataContractSurrogate
IDataContractSurrogate

Implementación de IDataContractSurrogate para personalizar el proceso de serialización.

dataContractResolver
DataContractResolver

Implementación de para DataContractResolver asignar xsi:type declaraciones a tipos de contrato de datos.

Comentarios

Advertencia

Este método no está disponible en Windows aplicaciones de la Tienda.

Se aplica a

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica el elemento XML raíz y el espacio de nombres en dos parámetros de cadena, así como una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos.

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))

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

rootName
String

Nombre del elemento raíz del contenido.

rootNamespace
String

Espacio de nombres del elemento raíz.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type que contiene los tipos que pueden estar presentes en el gráfico de objetos.

Ejemplos

En el ejemplo siguiente se crea una instancia de DataContractSerializer que especifica el tipo que se va a serializar o deserializar, así como el nombre XML y el espacio de nombres para leer o escribir en el documento XML. El código también crea una instancia de IEnumerable<T> para contener los tipos conocidos utilizados durante la serialización o deserialización.

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

Consulte también

Se aplica a

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado mediante el elemento raíz XML y el espacio de nombres especificados a través de los parámetros de tipo 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)

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

rootName
XmlDictionaryString

que XmlDictionaryString contiene el nombre del elemento raíz del contenido.

rootNamespace
XmlDictionaryString

que XmlDictionaryString contiene el espacio de nombres del elemento raíz.

Ejemplos

En el ejemplo siguiente se crea una instancia de DataContractSerializer que especifica el tipo que se va a serializar o deserializar, así como el nombre XML y el espacio de nombres (como XmlDictionaryString objetos) para leer o escribir en el documento XML.

public static void Constructor4()
{
    // Create an instance of the DataContractSerializer
    // specifying the type, and name and
    // namespace as XmlDictionaryString objects.

    // Create an XmlDictionary and add values to it.
    XmlDictionary d = new XmlDictionary();
    XmlDictionaryString name_value = d.Add("Customer");
    XmlDictionaryString ns_value = d.Add("http://www.contoso.com");

    // Create the serializer.
    DataContractSerializer ser =
        new DataContractSerializer(
        typeof(Person),
        name_value,
        ns_value);
    // Other code not shown.
}
Public Shared Sub Constructor4() 
    ' Create an instance of the DataContractSerializer
    ' specifying the type, and name and 
    ' namespace as XmlDictionaryString objects.
    ' Create an XmlDictionary and add values to it.
    Dim d As New XmlDictionary()
    Dim name_value As XmlDictionaryString = d.Add("Customer")
    Dim ns_value As XmlDictionaryString = d.Add("http://www.contoso.com")
    
    ' Create the serializer.
    Dim ser As New DataContractSerializer(GetType(Person), _
    name_value, _
    ns_value)

    ' Other code not shown.
End Sub

Se aplica a

DataContractSerializer(Type, String, String)

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado mediante el elemento raíz y el espacio de nombres XML proporcionados.

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)

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

rootName
String

Nombre del elemento XML que incluye el contenido que se va a serializar o deserializar.

rootNamespace
String

Espacio de nombres del elemento XML que incluye el contenido que se va a serializar o deserializar.

Ejemplos

En el ejemplo siguiente se crea una instancia de DataContractSerializer que especifica el tipo que se va a serializar o deserializar, así como el nombre XML y el espacio de nombres para leer o escribir en el documento XML.

public static void Constructor3()
{
    // Create an instance of the DataContractSerializer
    // specifying the type, and name and
    // namespace as strings.
    DataContractSerializer ser =
        new DataContractSerializer(
        typeof(Person),
        "Customer",
        "http://www.contoso.com");

    // Other code not shown.
}
Public Shared Sub Constructor3() 
    ' Create an instance of the DataContractSerializer
    ' specifying the type, and name and 
    ' namespace as strings.
    Dim ser As New DataContractSerializer(GetType(Person), _
    "Customer", _
    "http://www.contoso.com")

    ' Other code not shown.
End Sub

Se aplica a

DataContractSerializer(Type, DataContractSerializerSettings)

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo y la configuración especificados.

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)

Parámetros

type
Type

Tipo de la instancia que se va a serializar o deserializar.

settings
DataContractSerializerSettings

Configuración del serializador.

Se aplica a

DataContractSerializer(Type, IEnumerable<Type>)

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado y una colección de tipos conocidos que pueden estar presentes en el gráfico de objetos.

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))

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

knownTypes
IEnumerable<Type>

IEnumerable<T> de Type que contiene los tipos que pueden estar presentes en el gráfico de objetos.

Ejemplos

En el ejemplo siguiente se crea una instancia de DataContractSerializer que especifica el tipo que se va a serializar o deserializar y una colección de tipos conocidos que se pueden usar en el gráfico de objetos.

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

Consulte también

Se aplica a

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

Inicializa una nueva instancia de la DataContractSerializer clase para serializar o deserializar un objeto del tipo especificado. Este método también especifica el elemento XML raíz y el espacio de nombres en dos XmlDictionaryString parámetros, así como una lista de tipos conocidos que pueden estar presentes en el gráfico de objetos.

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))

Parámetros

type
Type

Tipo de las instancias que se serializan o deserializan.

rootName
XmlDictionaryString

que XmlDictionaryString contiene el nombre del elemento raíz del contenido.

rootNamespace
XmlDictionaryString

que XmlDictionaryString contiene el espacio de nombres del elemento raíz.

knownTypes
IEnumerable<Type>

de IEnumerable<T>Type que contiene los tipos conocidos que pueden estar presentes en el gráfico de objetos.

Ejemplos

En el ejemplo siguiente se crea una instancia de DataContractSerializer que especifica el tipo que se va a serializar o deserializar, así como el nombre XML y el espacio de nombres (como XmlDictionaryString objetos) para leer o escribir en el documento XML. El código también crea una instancia de IEnumerable<T> para contener los tipos conocidos utilizados durante la serialización o deserialización.

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

Consulte también

Se aplica a