NetDataContractSerializer Construtores

Referência

Definição

Namespace:: System.Runtime.Serialization

Assembly:: System.Runtime.Serialization.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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 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 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 DataContractSerializer seguir cria uma instância da especificação 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 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 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 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

ArgumentOutOfRangeException

O valor maxItemsInObjectGraph é menor que 0.

Exemplos

O exemplo a seguir cria uma instância do NetDataContractSerializer uso de um StreamingContext. O código também define e ignoreExtensionDataObjectespecifica uma implementação da interface a ISurrogateSelector 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

ArgumentOutOfRangeException

O valor maxItemsInObjectGraph é 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 interface a ISurrogateSelector 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

ArgumentOutOfRangeException

O valor maxItemsInObjectGraph é 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 interface a ISurrogateSelector 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

NetDataContractSerializer Construtores

Definição

Sobrecargas

NetDataContractSerializer()

Exemplos

Aplica-se a

NetDataContractSerializer(StreamingContext)

Parâmetros

Exemplos

Comentários

Aplica-se a

NetDataContractSerializer(String, String)

Parâmetros

Exemplos

Aplica-se a

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Parâmetros

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Recursos adicionais