NetDataContractSerializer Constructores

Referencia

Definición

Espacio de nombres:: System.Runtime.Serialization

Ensamblado:: System.Runtime.Serialization.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la clase NetDataContractSerializer.

Sobrecargas

NetDataContractSerializer()	Inicializa una nueva instancia de la clase NetDataContractSerializer.
NetDataContractSerializer(StreamingContext)	Inicializa una instancia nueva de la clase NetDataContractSerializer con los datos de contexto de transmisión por secuencias proporcionados.
NetDataContractSerializer(String, String)	Inicializa una instancia nueva de la clase NetDataContractSerializer con el elemento raíz y el espacio de nombres de XML proporcionados.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	Inicializa una instancia nueva de la clase NetDataContractSerializer con dos parámetros de tipo XmlDictionaryString que contienen el elemento raíz y el espacio de nombres utilizados para especificar el contenido.
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicializa una nueva instancia de la clase NetDataContractSerializer con los datos de contexto proporcionados; además, especifica el número máximo de elementos en el objeto que se va a serializar y los parámetros para especificar si se omiten los datos adicionales, el método de carga de ensamblado y un selector de suplentes.
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicializa una nueva instancia de la clase NetDataContractSerializer con los datos de contexto proporcionados y el nombre y espacio de nombres raíz; además, especifica el número máximo de elementos en el objeto que se va a serializar y los parámetros para especificar si se omiten los datos adicionales, el método de carga de ensamblado y un selector de suplentes.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicializa una nueva instancia de la clase NetDataContractSerializer con los datos de contexto proporcionados y el nombre y espacio de nombres raíz (como parámetros XmlDictionaryString); además, especifica el número máximo de elementos en el objeto que se va a serializar y los parámetros para especificar si se omiten los datos adicionales encontrados, el método de carga de ensamblado y un selector de suplentes.

NetDataContractSerializer()

Inicializa una nueva instancia de la clase NetDataContractSerializer.

public:
 NetDataContractSerializer();

public NetDataContractSerializer ();

Public Sub New ()

Ejemplos

public static void Constructor1()
{
    // Create an instance of the NetDataContractSerializer.
    NetDataContractSerializer ser =
        new NetDataContractSerializer();
    // Other code not shown.
}

Public Shared Sub Constructor1() 
    ' Create an instance of the NetDataContractSerializer.
    Dim ser As New System.Runtime.Serialization.NetDataContractSerializer()

End Sub 

' Other code not shown.

Se aplica a

NetDataContractSerializer(StreamingContext)

Inicializa una instancia nueva de la clase NetDataContractSerializer con los datos de contexto de transmisión por secuencias proporcionados.

public:
 NetDataContractSerializer(System::Runtime::Serialization::StreamingContext context);

public NetDataContractSerializer (System.Runtime.Serialization.StreamingContext context);

new System.Runtime.Serialization.NetDataContractSerializer : System.Runtime.Serialization.StreamingContext -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (context As StreamingContext)

Parámetros

context: StreamingContext

StreamingContext que contiene datos de contexto.

Ejemplos

En el ejemplo siguiente, se crea una instancia de NetDataContractSerializer utilizando StreamingContext.

public static void Constructor2()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);
    // Create a DatatContractSerializer with the collection.
    NetDataContractSerializer ser2 = new NetDataContractSerializer(sc);

    // Other code not shown.
}

Public Shared Sub Constructor2() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    ' Create a DatatContractSerializer with the collection.
    Dim ser2 As New System.Runtime.Serialization.NetDataContractSerializer(sc)

   ' Other code not shown.
End Sub

Comentarios

La clase StreamingContext le permite pasar datos del contexto específicos del usuario para utilizarlos al leer y escribir objetos.

Se aplica a

NetDataContractSerializer(String, String)

Inicializa una instancia nueva de la clase NetDataContractSerializer con el elemento raíz y el espacio de nombres de XML proporcionados.

public:
 NetDataContractSerializer(System::String ^ rootName, System::String ^ rootNamespace);

public NetDataContractSerializer (string rootName, string rootNamespace);

new System.Runtime.Serialization.NetDataContractSerializer : string * string -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (rootName As String, rootNamespace As String)

Parámetros

rootName: String

El nombre del elemento XML que incluye el contenido para serializar o deserializar.

rootNamespace: String

El espacio de nombres del elemento XML que incluye el contenido para serializar o deserializar.

Ejemplos

El ejemplo siguiente crea una instancia de DataContractSerializer que especifica el elemento raíz y el espacio de nombres de XML que esperará al deserializar un objeto.

public static void Constructor3()
{
    // Create an instance of the NetDataContractSerializer
    // specifying the name and namespace as strings.
    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        "Customer",
        "http://www.contoso.com");
    // Other code not shown.
}

Public Shared Sub Constructor3() 
    ' Create an instance of the NetDataContractSerializer
    ' specifying the name and namespace as strings.
    Dim ser As New System.Runtime.Serialization. _
       NetDataContractSerializer("Customer", "http://www.contoso.com")

   ' Other code not shown.

End Sub

Se aplica a

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Inicializa una instancia nueva de la clase NetDataContractSerializer con dos parámetros de tipo XmlDictionaryString que contienen el elemento raíz y el espacio de nombres utilizados para especificar el contenido.

public:
 NetDataContractSerializer(System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace);

public NetDataContractSerializer (System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace);

new System.Runtime.Serialization.NetDataContractSerializer : System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString)

Parámetros

rootName: XmlDictionaryString

XmlDictionaryString que contiene el nombre del elemento XML que incluye el contenido para serializar o deserializar.

rootNamespace: XmlDictionaryString

XmlDictionaryString que contiene el espacio de nombres del elemento XML que incluye el contenido para serializar o deserializar.

Ejemplos

El ejemplo siguiente crea una instancia de DataContractSerializer que especifica el elemento raíz y el espacio de nombres de XML (como argumentos XmlDictionaryString) que esperará al deserializar un objeto.

public static void Constructor4()
{
    // Create an XmlDictionary and add values to it.
    XmlDictionary d = new XmlDictionary();
    // Initialize the out variables.
    XmlDictionaryString name_value = d.Add("Customer");
    XmlDictionaryString ns_value = d.Add("http://www.contoso.com");

    // Create the serializer.
    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        name_value,
        ns_value);
    // Other code not shown.
}

 Public Shared Sub Constructor4() 
     ' 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 System.Runtime.Serialization. _
        NetDataContractSerializer(name_value, ns_value)

     ' Other code not shown.
 
 End Sub

Comentarios

XmlDictionaryString se puede utilizar para optimizar el rendimiento cuando el mismo conjunto de cadenas se utiliza en las instancias de objeto.

Se aplica a

NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Inicializa una nueva instancia de la clase NetDataContractSerializer con los datos de contexto proporcionados; además, especifica el número máximo de elementos en el objeto que se va a serializar y los parámetros para especificar si se omiten los datos adicionales, el método de carga de ensamblado y un selector de suplentes.

public:
 NetDataContractSerializer(System::Runtime::Serialization::StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System::Runtime::Serialization::Formatters::FormatterAssemblyStyle assemblyFormat, System::Runtime::Serialization::ISurrogateSelector ^ surrogateSelector);

public NetDataContractSerializer (System.Runtime.Serialization.StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System.Runtime.Serialization.Formatters.FormatterAssemblyStyle assemblyFormat, System.Runtime.Serialization.ISurrogateSelector surrogateSelector);

new System.Runtime.Serialization.NetDataContractSerializer : System.Runtime.Serialization.StreamingContext * int * bool * System.Runtime.Serialization.Formatters.FormatterAssemblyStyle * System.Runtime.Serialization.ISurrogateSelector -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (context As StreamingContext, maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, assemblyFormat As FormatterAssemblyStyle, surrogateSelector As ISurrogateSelector)

Parámetros

context: StreamingContext

StreamingContext que contiene datos de contexto.

maxItemsInObjectGraph: Int32

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

ignoreExtensionDataObject: Boolean

true para omitir los datos proporcionados por una extensión del tipo; de lo contrario, false.

assemblyFormat: FormatterAssemblyStyle

Un valor de enumeración FormatterAssemblyStyle que especifica un método para buscar y cargar los ensamblados.

surrogateSelector: ISurrogateSelector

Una implementación de ISurrogateSelector.

Excepciones

ArgumentOutOfRangeException

El valor de maxItemsInObjectGraph es menor que 0.

Ejemplos

En el ejemplo siguiente, se crea una instancia de NetDataContractSerializer utilizando StreamingContext. El código también establece ignoreExtensionDataObject y especifica una implementación de la interfaz ISurrogateSelector a administrar para ayudar al serializador cuando selecciona un suplente (para deserializar los tipos heredados).

public static void Constructor5()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);

    // Create an instance of a class that implements the
    // ISurrogateSelector interface. The implementation code
    // is not shown here.
    MySelector mySurrogateSelector = new MySelector();

    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        sc,
        int.MaxValue,
        true,
        FormatterAssemblyStyle.Simple,
        mySurrogateSelector);

    // Other code not shown.
}

Public Shared Sub Constructor5() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    
    ' Create an instance of a class that implements the 
    ' ISurrogateSelector interface. The implementation code
    ' is not shown here.
    Dim mySurrogateSelector As New MySelector()
    
    Dim ser As New System.Runtime.Serialization. _
    NetDataContractSerializer _
    (sc, _
     65536, _
     True, _
     FormatterAssemblyStyle.Simple, _
     mySurrogateSelector)

    ' Other code not shown.
End Sub

Comentarios

Se utiliza el parámetro ignoreExtensionDataObject cuando la interfaz IExtensibleDataObject se implementa en la clase que se está serializando o deserializando.

Se aplica a

NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Inicializa una nueva instancia de la clase NetDataContractSerializer con los datos de contexto proporcionados y el nombre y espacio de nombres raíz; además, especifica el número máximo de elementos en el objeto que se va a serializar y los parámetros para especificar si se omiten los datos adicionales, el método de carga de ensamblado y un selector de suplentes.

public:
 NetDataContractSerializer(System::String ^ rootName, System::String ^ rootNamespace, System::Runtime::Serialization::StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System::Runtime::Serialization::Formatters::FormatterAssemblyStyle assemblyFormat, System::Runtime::Serialization::ISurrogateSelector ^ surrogateSelector);

public NetDataContractSerializer (string rootName, string rootNamespace, System.Runtime.Serialization.StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System.Runtime.Serialization.Formatters.FormatterAssemblyStyle assemblyFormat, System.Runtime.Serialization.ISurrogateSelector surrogateSelector);

new System.Runtime.Serialization.NetDataContractSerializer : string * string * System.Runtime.Serialization.StreamingContext * int * bool * System.Runtime.Serialization.Formatters.FormatterAssemblyStyle * System.Runtime.Serialization.ISurrogateSelector -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (rootName As String, rootNamespace As String, context As StreamingContext, maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, assemblyFormat As FormatterAssemblyStyle, surrogateSelector As ISurrogateSelector)

Parámetros

rootName: String

El nombre del elemento XML que incluye el contenido para serializar o deserializar.

rootNamespace: String

El espacio de nombres del elemento XML que incluye el contenido para serializar o deserializar.

context: StreamingContext

StreamingContext que contiene datos de contexto.

maxItemsInObjectGraph: Int32

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

ignoreExtensionDataObject: Boolean

true para omitir los datos proporcionados por una extensión del tipo; de lo contrario, false.

assemblyFormat: FormatterAssemblyStyle

Un valor de enumeración FormatterAssemblyStyle que especifica un método para buscar y cargar los ensamblados.

surrogateSelector: ISurrogateSelector

Una implementación de IDataContractSurrogate para administrar el tipo heredado.

Excepciones

ArgumentOutOfRangeException

El valor de maxItemsInObjectGraph es menor que 0.

Ejemplos

El ejemplo siguiente crea una instancia de NetDataContractSerializer que especifica el nombre y el espacio de nombres del elemento XML que se deben esperar al deserializar. El código también establece ignoreExtensionDataObject y especifica una implementación de la interfaz ISurrogateSelector a administrar para ayudar al serializador cuando selecciona un suplente (para deserializar los tipos heredados).

public static void Constructor6()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);

    // Create an instance of a class that implements the
    // ISurrogateSelector interface. The implementation code
    // is not shown here.
    MySelector mySurrogateSelector = new MySelector();

    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        "Customer",
        "http://www.contoso.com",
        sc,
        int.MaxValue,
        true,
        FormatterAssemblyStyle.Simple,
        mySurrogateSelector);
    // Other code not shown.
}

Public Shared Sub Constructor6() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    
    ' Create an instance of a class that implements the 
    ' ISurrogateSelector interface. The implementation code
    ' is not shown here.
    Dim mySurrogateSelector As New MySelector()
    
    Dim ser As New System.Runtime.Serialization. _
      NetDataContractSerializer( _
      "Customer", _
      "http://www.contoso.com", _
      sc, _
      65536, _
      True, _
      FormatterAssemblyStyle.Simple, _
      mySurrogateSelector)

    ' Other code not shown.            

End Sub

Comentarios

Se utiliza el parámetro ignoreExtensionDataObject cuando la interfaz IExtensibleDataObject se implementa en la clase que se está serializando o deserializando.

Se aplica a

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Inicializa una nueva instancia de la clase NetDataContractSerializer con los datos de contexto proporcionados y el nombre y espacio de nombres raíz (como parámetros XmlDictionaryString); además, especifica el número máximo de elementos en el objeto que se va a serializar y los parámetros para especificar si se omiten los datos adicionales encontrados, el método de carga de ensamblado y un selector de suplentes.

public:
 NetDataContractSerializer(System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace, System::Runtime::Serialization::StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System::Runtime::Serialization::Formatters::FormatterAssemblyStyle assemblyFormat, System::Runtime::Serialization::ISurrogateSelector ^ surrogateSelector);

public NetDataContractSerializer (System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace, System.Runtime.Serialization.StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System.Runtime.Serialization.Formatters.FormatterAssemblyStyle assemblyFormat, System.Runtime.Serialization.ISurrogateSelector surrogateSelector);

new System.Runtime.Serialization.NetDataContractSerializer : System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString * System.Runtime.Serialization.StreamingContext * int * bool * System.Runtime.Serialization.Formatters.FormatterAssemblyStyle * System.Runtime.Serialization.ISurrogateSelector -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString, context As StreamingContext, maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, assemblyFormat As FormatterAssemblyStyle, surrogateSelector As ISurrogateSelector)

Parámetros

rootName: XmlDictionaryString

XmlDictionaryString que contiene el elemento raíz del contenido.

rootNamespace: XmlDictionaryString

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

context: StreamingContext

StreamingContext que contiene datos de contexto.

maxItemsInObjectGraph: Int32

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

ignoreExtensionDataObject: Boolean

true para omitir los datos proporcionados por una extensión del tipo; de lo contrario, false.

assemblyFormat: FormatterAssemblyStyle

Un valor de enumeración FormatterAssemblyStyle que especifica un método para buscar y cargar los ensamblados.

surrogateSelector: ISurrogateSelector

Una implementación de IDataContractSurrogate para administrar el tipo heredado.

Excepciones

ArgumentOutOfRangeException

El valor de maxItemsInObjectGraph es menor que 0.

Ejemplos

En el ejemplo siguiente se crea una instancia de NetDataContractSerializer que especifica el nombre y el espacio de nombres del elemento XML (como argumentos XmlDictionaryString) que se deben esperar al deserializar. El código también establece ignoreExtensionDataObject y especifica una implementación de la interfaz ISurrogateSelector a administrar para ayudar al serializador cuando selecciona un suplente (para deserializar los tipos heredados).

public static void Constructor7()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);

    // 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
    // ISurrogateSelector interface. The implementation code
    // is not shown here.
    MySelector mySurrogateSelector = new MySelector();

    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        name_value,
        ns_value,
        sc,
        int.MaxValue,
        true,
        FormatterAssemblyStyle.Simple,
        mySurrogateSelector);

    // Other code not shown.
}

Public Shared Sub Constructor7() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    
    ' 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 
    ' ISurrogateSelector interface. The implementation code
    ' is not shown here.
    Dim mySurrogateSelector As New MySelector()
    
    Dim ser As New System.Runtime.Serialization. _
      NetDataContractSerializer( _
      name_value, _
      ns_value, _
      sc, _
      65536, _
      True, _
      FormatterAssemblyStyle.Simple, _
      mySurrogateSelector)

    ' Other code not shown.    

End Sub

Comentarios

XmlDictionaryString se puede utilizar para optimizar el rendimiento cuando el mismo conjunto de cadenas se utiliza en las instancias de objeto.

Se utiliza el parámetro ignoreExtensionDataObject cuando la interfaz IExtensibleDataObject se implementa en la clase que se está serializando o deserializando.

Se aplica a

NetDataContractSerializer Constructores

Definición

Sobrecargas

NetDataContractSerializer()

Ejemplos

Se aplica a

NetDataContractSerializer(StreamingContext)

Parámetros

Ejemplos

Comentarios

Se aplica a

NetDataContractSerializer(String, String)

Parámetros

Ejemplos

Se aplica a

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Parámetros

Ejemplos

Comentarios

Se aplica a

NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

Recursos adicionales