NetDataContractSerializer Construtores

Definição

Inicializa uma nova instância da NetDataContractSerializer classe.

Sobrecargas

Name Description
NetDataContractSerializer()

Inicializa uma nova instância da NetDataContractSerializer classe.

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 fornecido e o namespace.

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Inicializa uma nova instância da NetDataContractSerializer classe com dois parâmetros do 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 NetDataContractSerializer classe com os dados de contexto fornecidos; além disso, especifica o número máximo de itens no objeto a serializar, e parâmetros para especificar se dados adicionais são ignorados, o método de carregamento de montagem e um seletor substituto.

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

Inicializa uma nova instância da NetDataContractSerializer classe com os dados de contexto fornecidos, nome raiz e espaço de nomes; adicionalmente, especifica o número máximo de itens no objeto a serializar, e parâmetros para especificar se dados adicionais são ignorados, o método de carregamento assembly e um seletor substituto.

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

Inicializa uma nova instância da NetDataContractSerializer classe com os dados de contexto fornecidos, nome raiz e espaço de nomes (como XmlDictionaryString parâmetros); adicionalmente, especifica o número máximo de itens no objeto a serializar, e parâmetros para especificar se os dados extra encontrados são ignorados, método de carregamento em assembly e um seletor substituto.

NetDataContractSerializer()

Inicializa uma nova instância da NetDataContractSerializer classe.

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

A StreamingContext que contém dados de contexto.

Exemplos

O exemplo seguinte 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

Observações

A StreamingContext aula permite-lhe passar dados contextuais específicos do utilizador para usar enquanto lê e escreve objetos.

Aplica-se a

NetDataContractSerializer(String, String)

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

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 envolve o conteúdo a serializar ou desserializar.

rootNamespace
String

O namespace do elemento XML que envolve o conteúdo a serializar ou desserializar.

Exemplos

O exemplo seguinte cria uma instância de DataContractSerializer especificar o elemento raiz XML e o namespace que esperará 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 do 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 envolve o conteúdo a serializar ou desserializar.

rootNamespace
XmlDictionaryString

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

Exemplos

O exemplo seguinte cria uma instância de DataContractSerializer especificar o elemento raiz XML e o namespace (como XmlDictionaryString argumentos) que será esperado 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

Observações

Podem XmlDictionaryString ser usados para otimizar o desempenho quando o mesmo conjunto de cadeias é usado entre instâncias de objetos.

Aplica-se a

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

Inicializa uma nova instância da NetDataContractSerializer classe com os dados de contexto fornecidos; além disso, especifica o número máximo de itens no objeto a serializar, e parâmetros para especificar se dados adicionais são ignorados, o método de carregamento de montagem 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

A StreamingContext que contém dados de contexto.

maxItemsInObjectGraph
Int32

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

ignoreExtensionDataObject
Boolean

true 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 conjuntos.

surrogateSelector
ISurrogateSelector

Uma implementação do ISurrogateSelector.

Exceções

maxItemsInObjectGraph valor é inferior a 0.

Exemplos

O exemplo seguinte cria uma instância do NetDataContractSerializer usando um StreamingContext. O código também define o ignoreExtensionDataObject, e especifica uma implementação da ISurrogateSelector interface a tratar para ajudar o serializador ao selecionar um substituto (para desserializar tipos legados).

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

Observações

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

Aplica-se a

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

Inicializa uma nova instância da NetDataContractSerializer classe com os dados de contexto fornecidos, nome raiz e espaço de nomes; adicionalmente, especifica o número máximo de itens no objeto a serializar, e parâmetros para especificar se dados adicionais são ignorados, o método de carregamento 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 envolve o conteúdo a serializar ou desserializar.

rootNamespace
String

O namespace do elemento XML que envolve o conteúdo a serializar ou desserializar.

context
StreamingContext

A StreamingContext que contém dados de contexto.

maxItemsInObjectGraph
Int32

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

ignoreExtensionDataObject
Boolean

true 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 conjuntos.

surrogateSelector
ISurrogateSelector

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

Exceções

maxItemsInObjectGraph valor é inferior a 0.

Exemplos

O exemplo seguinte cria uma instância da NetDataContractSerializer especificação do nome e espaço de nomes do elemento XML a esperar ao desserializar. O código também define o ignoreExtensionDataObject, e especifica uma implementação da ISurrogateSelector interface a tratar para ajudar o serializador ao selecionar um substituto (para desserializar tipos legados).

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

Observações

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

Aplica-se a

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

Inicializa uma nova instância da NetDataContractSerializer classe com os dados de contexto fornecidos, nome raiz e espaço de nomes (como XmlDictionaryString parâmetros); adicionalmente, especifica o número máximo de itens no objeto a serializar, e parâmetros para especificar se os dados extra encontrados são ignorados, método de carregamento em 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

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

rootNamespace
XmlDictionaryString

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

context
StreamingContext

A StreamingContext que contém dados de contexto.

maxItemsInObjectGraph
Int32

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

ignoreExtensionDataObject
Boolean

true 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 conjuntos.

surrogateSelector
ISurrogateSelector

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

Exceções

maxItemsInObjectGraph valor é inferior a 0.

Exemplos

O exemplo seguinte cria uma instância de NetDataContractSerializer especificar o nome do elemento XML e o namespace (como XmlDictionaryString argumentos) a esperar ao desserializar. O código também define o ignoreExtensionDataObject, e especifica uma implementação da ISurrogateSelector interface a tratar para ajudar o serializador ao selecionar um substituto (para desserializar tipos legados).

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

Observações

Podem XmlDictionaryString ser usados para otimizar o desempenho quando o mesmo conjunto de cadeias é usado entre instâncias de objetos.

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

Aplica-se a