Partilhar via


NetDataContractSerializer Construtores

Definição

Inicializa uma nova instância da classe NetDataContractSerializer.

Sobrecargas

NetDataContractSerializer()

Inicializa uma nova instância da classe NetDataContractSerializer.

NetDataContractSerializer(StreamingContext)

Inicializa uma nova instância da classe NetDataContractSerializer com os dados de contexto de fluxo fornecidos.

NetDataContractSerializer(String, String)

Inicializa uma nova instância da classe NetDataContractSerializer com o namespace e o elemento raiz XML fornecidos.

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Inicializa uma nova instância da classe NetDataContractSerializer com dois parâmetros do tipo XmlDictionaryString que contêm o elemento raiz e o namespace usado para especificar o conteúdo.

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

Inicializa uma nova instância da classe NetDataContractSerializer com os dados de contexto fornecidos; além disso, especifica o número máximo de itens no objeto a serem serializados e os parâmetros para especificar se os dados extras serão ignorados, o método de carregamento do assembly e um seletor substituto.

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

Inicializa uma nova instância da classe NetDataContractSerializer com o namespace e o nome de raiz e dados de contexto fornecidos; além disso, especifica o número máximo de itens no objeto a serem serializados e os parâmetros para especificar se os dados extras serão ignorados, o método de carregamento do assembly e um seletor substituto.

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

Inicializa uma nova instância da classe NetDataContractSerializer com o namespace e o nome de raiz e dados de contexto fornecidos (como parâmetros XmlDictionaryString); além disso, especifica o número máximo de itens no objeto a serem serializados e os parâmetros para especificar se os dados extras encontrados serão ignorados, o método de carregamento de assembly e um seletor substituto.

NetDataContractSerializer()

Inicializa uma nova instância da classe NetDataContractSerializer.

public:
 NetDataContractSerializer();
public NetDataContractSerializer ();
Public Sub New ()

Exemplos

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.

Aplica-se a

NetDataContractSerializer(StreamingContext)

Inicializa uma nova instância da classe NetDataContractSerializer com os dados de contexto de fluxo fornecidos.

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

Um StreamingContext que contém dados de contexto.

Exemplos

O exemplo a seguir cria uma instância do NetDataContractSerializer usando um 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

Comentários

A StreamingContext classe permite que você passe dados de contexto específicos do usuário a serem usados durante a leitura e gravação de objetos.

Aplica-se a

NetDataContractSerializer(String, String)

Inicializa uma nova instância da classe NetDataContractSerializer com o namespace e o elemento raiz XML fornecidos.

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

O nome do elemento XML que inclui o conteúdo para serializar ou desserializar.

rootNamespace
String

O namespace do elemento XML que inclui o conteúdo a ser serializado ou desserializado.

Exemplos

O exemplo a seguir cria uma instância do que especifica o DataContractSerializer elemento raiz XML e o namespace que ele espera ao desserializar um 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

Aplica-se a

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Inicializa uma nova instância da classe NetDataContractSerializer com dois parâmetros do tipo XmlDictionaryString que contêm o elemento raiz e o namespace usado para especificar o conteúdo.

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

Um XmlDictionaryString que contém o nome do elemento XML que inclui o conteúdo a serializar ou desserializar.

rootNamespace
XmlDictionaryString

Um XmlDictionaryString que contém o namespace do elemento XML que inclui o conteúdo a serializar ou desserializar.

Exemplos

O exemplo a seguir cria uma instância do que especifica o DataContractSerializer elemento raiz XML e o namespace (como XmlDictionaryString argumentos) que ele espera ao desserializar um 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

Comentários

O XmlDictionaryString pode ser usado para otimizar o desempenho quando o mesmo conjunto de cadeias de caracteres é usado entre instâncias de objeto.

Aplica-se a

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

Inicializa uma nova instância da classe NetDataContractSerializer com os dados de contexto fornecidos; além disso, especifica o número máximo de itens no objeto a serem serializados e os parâmetros para especificar se os dados extras serão ignorados, o método de carregamento do assembly e um seletor substituto.

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

Um StreamingContext que contém dados de contexto.

maxItemsInObjectGraph
Int32

O número máximo de itens no grafo a serem serializados ou desserializados.

ignoreExtensionDataObject
Boolean

true para ignorar os dados fornecidos por uma extensão do tipo; caso contrário, false.

assemblyFormat
FormatterAssemblyStyle

Um valor de enumeração FormatterAssemblyStyle que especifica um método para localizar e carregar assemblies.

surrogateSelector
ISurrogateSelector

Uma implementação de ISurrogateSelector.

Exceções

O valor maxItemsInObjectGraph é menor que 0.

Exemplos

O exemplo a seguir cria uma instância do NetDataContractSerializer usando um StreamingContext. O código também define o ignoreExtensionDataObjecte especifica uma implementação da ISurrogateSelector interface a ser manipulada para ajudar o serializador ao selecionar um substituto (para desserializar tipos herdados).

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

Comentários

O ignoreExtensionDataObject parâmetro é usado quando a IExtensibleDataObject interface é implementada na classe que está sendo serializada ou desserializada.

Aplica-se a

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

Inicializa uma nova instância da classe NetDataContractSerializer com o namespace e o nome de raiz e dados de contexto fornecidos; além disso, especifica o número máximo de itens no objeto a serem serializados e os parâmetros para especificar se os dados extras serão ignorados, o método de carregamento do assembly e um seletor substituto.

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

O nome do elemento XML que inclui o conteúdo para serializar ou desserializar.

rootNamespace
String

O namespace do elemento XML que inclui o conteúdo a ser serializado ou desserializado.

context
StreamingContext

Um StreamingContext que contém dados de contexto.

maxItemsInObjectGraph
Int32

O número máximo de itens no grafo a serem serializados ou desserializados.

ignoreExtensionDataObject
Boolean

true para ignorar os dados fornecidos por uma extensão do tipo; caso contrário, false.

assemblyFormat
FormatterAssemblyStyle

Um valor de enumeração FormatterAssemblyStyle que especifica um método para localizar e carregar assemblies.

surrogateSelector
ISurrogateSelector

Uma implementação de IDataContractSurrogate para lidar com o tipo herdado.

Exceções

O valor maxItemsInObjectGraph é menor que 0.

Exemplos

O exemplo a seguir cria uma instância do que especifica o NetDataContractSerializer nome do elemento XML e o namespace a serem esperados ao desserializar. O código também define o ignoreExtensionDataObjecte especifica uma implementação da ISurrogateSelector interface a ser manipulada para ajudar o serializador ao selecionar um substituto (para desserializar tipos herdados).

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

Comentários

O ignoreExtensionDataObject parâmetro é usado quando a IExtensibleDataObject interface é implementada na classe que está sendo serializada ou desserializada.

Aplica-se a

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

Inicializa uma nova instância da classe NetDataContractSerializer com o namespace e o nome de raiz e dados de contexto fornecidos (como parâmetros XmlDictionaryString); além disso, especifica o número máximo de itens no objeto a serem serializados e os parâmetros para especificar se os dados extras encontrados serão ignorados, o método de carregamento de assembly e um seletor substituto.

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

Um XmlDictionaryString que contém o elemento raiz do conteúdo.

rootNamespace
XmlDictionaryString

Um XmlDictionaryString que contém o namespace do elemento raiz.

context
StreamingContext

Um StreamingContext que contém dados de contexto.

maxItemsInObjectGraph
Int32

O número máximo de itens no grafo a serem serializados ou desserializados.

ignoreExtensionDataObject
Boolean

true para ignorar os dados fornecidos por uma extensão do tipo; caso contrário, false.

assemblyFormat
FormatterAssemblyStyle

Um valor de enumeração FormatterAssemblyStyle que especifica um método para localizar e carregar assemblies.

surrogateSelector
ISurrogateSelector

Uma implementação de IDataContractSurrogate para lidar com o tipo herdado.

Exceções

O valor maxItemsInObjectGraph é menor que 0.

Exemplos

O exemplo a seguir cria uma instância do que especifica o NetDataContractSerializer nome e o namespace do elemento XML (como XmlDictionaryString argumentos) a serem esperados ao desserializar. O código também define o ignoreExtensionDataObjecte especifica uma implementação da ISurrogateSelector interface a ser manipulada para ajudar o serializador ao selecionar um substituto (para desserializar tipos herdados).

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

Comentários

O XmlDictionaryString pode ser usado para otimizar o desempenho quando o mesmo conjunto de cadeias de caracteres é usado entre instâncias de objeto.

O ignoreExtensionDataObject parâmetro é usado quando a IExtensibleDataObject interface é implementada na classe que está sendo serializada ou desserializada.

Aplica-se a