NetDataContractSerializer Construtores
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.