NetDataContractSerializer Constructores

Definición

Inicializa una nueva instancia de la clase NetDataContractSerializer.

Sobrecargas

Nombre Description
NetDataContractSerializer()

Inicializa una nueva instancia de la clase NetDataContractSerializer.

NetDataContractSerializer(StreamingContext)

Inicializa una nueva instancia de la NetDataContractSerializer clase con los datos de contexto de streaming proporcionados.

NetDataContractSerializer(String, String)

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

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

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

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

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

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

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

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

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

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 nueva instancia de la NetDataContractSerializer clase con los datos de contexto de streaming 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

que StreamingContext contiene datos de contexto.

Ejemplos

En el ejemplo siguiente se crea una instancia de NetDataContractSerializer mediante .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 StreamingContext clase permite pasar datos de contexto específicos del usuario para usarlos al leer y escribir objetos.

Se aplica a

NetDataContractSerializer(String, String)

Inicializa una nueva instancia de la NetDataContractSerializer clase con el elemento raíz XML y el espacio de nombres 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

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 que DataContractSerializer especifica el elemento raíz XML y el espacio de nombres 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 nueva instancia de la NetDataContractSerializer clase con dos parámetros de tipo XmlDictionaryString que contienen el elemento raíz y el espacio de nombres usados 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

que XmlDictionaryString contiene el nombre del elemento XML que incluye el contenido que se va a serializar o deserializar.

rootNamespace
XmlDictionaryString

que XmlDictionaryString contiene el 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 que DataContractSerializer especifica el elemento raíz XML y el espacio de nombres (como XmlDictionaryString argumentos) 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 usar para optimizar el rendimiento cuando se usa el mismo conjunto de cadenas en las instancias de objeto.

Se aplica a

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

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

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

que StreamingContext 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 pasar por alto los datos proporcionados por una extensión del tipo; de lo contrario, false.

assemblyFormat
FormatterAssemblyStyle

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

surrogateSelector
ISurrogateSelector

Implementación de .ISurrogateSelector

Excepciones

maxItemsInObjectGraph el valor es menor que 0.

Ejemplos

En el ejemplo siguiente se crea una instancia de NetDataContractSerializer mediante .StreamingContext El código también establece y ignoreExtensionDataObjectespecifica una implementación de la ISurrogateSelector interfaz que se va a controlar para ayudar al serializador al seleccionar un suplente (para deserializar 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

El ignoreExtensionDataObject parámetro se usa cuando la IExtensibleDataObject interfaz 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 NetDataContractSerializer clase con los datos de contexto proporcionados, el nombre raíz y el espacio de nombres; además, especifica el número máximo de elementos del objeto que se va a serializar y los parámetros para especificar si se omiten datos adicionales, el método de carga de ensamblados y un selector suplente.

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

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.

context
StreamingContext

que StreamingContext 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 pasar por alto los datos proporcionados por una extensión del tipo; de lo contrario, false.

assemblyFormat
FormatterAssemblyStyle

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

surrogateSelector
ISurrogateSelector

Implementación de IDataContractSurrogate para controlar el tipo heredado.

Excepciones

maxItemsInObjectGraph el valor es menor que 0.

Ejemplos

En el ejemplo siguiente se crea una instancia de que NetDataContractSerializer especifica el nombre y el espacio de nombres del elemento XML que se esperan al deserializar. El código también establece y ignoreExtensionDataObjectespecifica una implementación de la ISurrogateSelector interfaz que se va a controlar para ayudar al serializador al seleccionar un suplente (para deserializar 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

El ignoreExtensionDataObject parámetro se usa cuando la IExtensibleDataObject interfaz 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 NetDataContractSerializer clase con los datos de contexto proporcionados y el nombre raíz y el espacio de nombres (como XmlDictionaryString parámetros); además, especifica el número máximo de elementos del objeto que se va a serializar y los parámetros para especificar si se omiten datos adicionales encontrados, el método de carga de ensamblados y un selector suplente.

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

que XmlDictionaryString contiene el elemento raíz del contenido.

rootNamespace
XmlDictionaryString

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

context
StreamingContext

que StreamingContext 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 pasar por alto los datos proporcionados por una extensión del tipo; de lo contrario, false.

assemblyFormat
FormatterAssemblyStyle

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

surrogateSelector
ISurrogateSelector

Implementación de IDataContractSurrogate para controlar el tipo heredado.

Excepciones

maxItemsInObjectGraph el valor es menor que 0.

Ejemplos

En el ejemplo siguiente se crea una instancia de que NetDataContractSerializer especifica el nombre del elemento XML y el espacio de nombres (como XmlDictionaryString argumentos) que se esperan al deserializar. El código también establece y ignoreExtensionDataObjectespecifica una implementación de la ISurrogateSelector interfaz que se va a controlar para ayudar al serializador al seleccionar un suplente (para deserializar 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 usar para optimizar el rendimiento cuando se usa el mismo conjunto de cadenas en las instancias de objeto.

El ignoreExtensionDataObject parámetro se usa cuando la IExtensibleDataObject interfaz se implementa en la clase que se está serializando o deserializando.

Se aplica a