NetDataContractSerializer Construtores

Definição

Inicializa uma nova instância da classe NetDataContractSerializer.

Sobrecargas

Nome Description
NetDataContractSerializer()

Inicializa uma nova instância da classe NetDataContractSerializer.

NetDataContractSerializer(StreamingContext)

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

NetDataContractSerializer(String, String)

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

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

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

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

Inicializa uma nova instância da classe com os dados de NetDataContractSerializer contexto fornecidos; além disso, especifica o número máximo de itens no objeto a serem serializados e parâmetros para especificar se dados extras sã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 com os dados de NetDataContractSerializer contexto fornecidos e o nome raiz e o namespace; além disso, especifica o número máximo de itens no objeto a serem serializados e parâmetros para especificar se dados extras sã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 com os dados de NetDataContractSerializer contexto fornecidos e o nome raiz e o namespace (como XmlDictionaryString parâmetros); além disso, especifica o número máximo de itens no objeto a serem serializados e parâmetros para especificar se os dados extras encontrados são ignorados, o método de carregamento do 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 NetDataContractSerializer classe com os dados de contexto de streaming 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 NetDataContractSerializer seguir cria uma instância do uso de 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 para usar durante a leitura e gravação de objetos.

Aplica-se a

NetDataContractSerializer(String, String)

Inicializa uma nova instância da NetDataContractSerializer classe com o elemento raiz XML e o namespace 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 para serializar ou desserializar.

Exemplos

O exemplo a DataContractSerializer seguir cria uma instância do elemento raiz XML e do 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 NetDataContractSerializer classe com dois parâmetros de tipo XmlDictionaryString que contêm o elemento raiz e o namespace usados 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 para serializar ou desserializar.

rootNamespace
XmlDictionaryString

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

Exemplos

O exemplo a DataContractSerializer seguir cria uma instância da especificação do elemento raiz XML e do 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

Pode XmlDictionaryString 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 com os dados de NetDataContractSerializer contexto fornecidos; além disso, especifica o número máximo de itens no objeto a serem serializados e parâmetros para especificar se dados extras sã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 para serializar ou desserializar.

ignoreExtensionDataObject
Boolean

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

assemblyFormat
FormatterAssemblyStyle

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

surrogateSelector
ISurrogateSelector

Uma implementação do ISurrogateSelector.

Exceções

maxItemsInObjectGraph o valor é menor que 0.

Exemplos

O exemplo a NetDataContractSerializer seguir cria uma instância do uso de um StreamingContext. O código também define e ignoreExtensionDataObjectespecifica 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 com os dados de NetDataContractSerializer contexto fornecidos e o nome raiz e o namespace; além disso, especifica o número máximo de itens no objeto a serem serializados e parâmetros para especificar se dados extras sã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 para serializar ou desserializar.

context
StreamingContext

Um StreamingContext que contém dados de contexto.

maxItemsInObjectGraph
Int32

O número máximo de itens no grafo para serializar ou desserializar.

ignoreExtensionDataObject
Boolean

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

assemblyFormat
FormatterAssemblyStyle

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

surrogateSelector
ISurrogateSelector

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

Exceções

maxItemsInObjectGraph o valor é menor que 0.

Exemplos

O exemplo a NetDataContractSerializer seguir cria uma instância da especificação do nome do elemento XML e do namespace a ser esperado ao desserializar. O código também define e ignoreExtensionDataObjectespecifica 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 com os dados de NetDataContractSerializer contexto fornecidos e o nome raiz e o namespace (como XmlDictionaryString parâmetros); além disso, especifica o número máximo de itens no objeto a serem serializados e parâmetros para especificar se os dados extras encontrados são ignorados, o método de carregamento do 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 para serializar ou desserializar.

ignoreExtensionDataObject
Boolean

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

assemblyFormat
FormatterAssemblyStyle

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

surrogateSelector
ISurrogateSelector

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

Exceções

maxItemsInObjectGraph o valor é menor que 0.

Exemplos

O exemplo a NetDataContractSerializer seguir cria uma instância da especificação do nome e do namespace do elemento XML (como XmlDictionaryString argumentos) a serem esperados ao desserializar. O código também define e ignoreExtensionDataObjectespecifica 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

Pode XmlDictionaryString 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