NetDataContractSerializer Konstruktorer
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Initierar en ny instans av NetDataContractSerializer klassen.
Överlagringar
| Name | Description |
|---|---|
| NetDataContractSerializer() |
Initierar en ny instans av NetDataContractSerializer klassen. |
| NetDataContractSerializer(StreamingContext) |
Initierar en ny instans av NetDataContractSerializer klassen med angivna strömmande kontextdata. |
| NetDataContractSerializer(String, String) |
Initierar en ny instans av NetDataContractSerializer klassen med det angivna XML-rotelementet och namnområdet. |
| NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString) |
Initierar en ny instans av NetDataContractSerializer klassen med två parametrar av typen XmlDictionaryString som innehåller rotelementet och namnområdet som används för att ange innehållet. |
| NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initierar en ny instans av NetDataContractSerializer klassen med angivna kontextdata. Dessutom anger det maximala antalet objekt i objektet som ska serialiseras och parametrar för att ange om extra data ignoreras, metoden för sammansättningsinläsning och en surrogatväljare. |
| NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initierar en ny instans av NetDataContractSerializer klassen med angivna kontextdata och rotnamn och namnområde. Dessutom anger det maximala antalet objekt i objektet som ska serialiseras och parametrar för att ange om extra data ignoreras, metoden för sammansättningsinläsning och en surrogatväljare. |
| NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initierar en ny instans av NetDataContractSerializer klassen med angivna kontextdata och rotnamn och namnområde (som XmlDictionaryString parametrar), anger dessutom det maximala antalet objekt i objektet som ska serialiseras och parametrar för att ange om extra data som hittas ignoreras, metoden för inläsning av sammansättning och en surrogatväljare. |
NetDataContractSerializer()
Initierar en ny instans av NetDataContractSerializer klassen.
public:
NetDataContractSerializer();
public NetDataContractSerializer();
Public Sub New ()
Exempel
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.
Gäller för
NetDataContractSerializer(StreamingContext)
Initierar en ny instans av NetDataContractSerializer klassen med angivna strömmande kontextdata.
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)
Parametrar
- context
- StreamingContext
En StreamingContext som innehåller kontextdata.
Exempel
I följande exempel skapas en instans av med hjälp av NetDataContractSerializer en 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
Kommentarer
Med StreamingContext klassen kan du skicka in användarspecifika kontextdata som ska användas när du läser och skriver objekt.
Gäller för
NetDataContractSerializer(String, String)
Initierar en ny instans av NetDataContractSerializer klassen med det angivna XML-rotelementet och namnområdet.
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)
Parametrar
- rootName
- String
Namnet på XML-elementet som omger innehållet för att serialisera eller deserialisera.
- rootNamespace
- String
Namnområdet för XML-elementet som omger innehållet för att serialisera eller deserialisera.
Exempel
I följande exempel skapas en instans av DataContractSerializer det xml-rotelement och namnområde som förväntas när ett objekt deserialiseras.
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
Gäller för
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)
Initierar en ny instans av NetDataContractSerializer klassen med två parametrar av typen XmlDictionaryString som innehåller rotelementet och namnområdet som används för att ange innehållet.
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)
Parametrar
- rootName
- XmlDictionaryString
En XmlDictionaryString som innehåller namnet på XML-elementet som omger innehållet för serialisering eller deserialisering.
- rootNamespace
- XmlDictionaryString
En XmlDictionaryString som innehåller namnområdet för XML-elementet som omger innehållet för serialisering eller deserialisering.
Exempel
I följande exempel skapas en instans av DataContractSerializer det xml-rotelement och namnområde (som argument) som XmlDictionaryString förväntas när ett objekt deserialiseras.
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
Kommentarer
XmlDictionaryString Kan användas för att optimera prestanda när samma uppsättning strängar används mellan objektinstanser.
Gäller för
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initierar en ny instans av NetDataContractSerializer klassen med angivna kontextdata. Dessutom anger det maximala antalet objekt i objektet som ska serialiseras och parametrar för att ange om extra data ignoreras, metoden för sammansättningsinläsning och en surrogatväljare.
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)
Parametrar
- context
- StreamingContext
En StreamingContext som innehåller kontextdata.
- maxItemsInObjectGraph
- Int32
Det maximala antalet objekt i diagrammet som ska serialiseras eller deserialiseras.
- ignoreExtensionDataObject
- Boolean
trueför att ignorera de data som tillhandahålls av ett tillägg av typen; annars . false
- assemblyFormat
- FormatterAssemblyStyle
Ett FormatterAssemblyStyle uppräkningsvärde som anger en metod för att hitta och läsa in sammansättningar.
- surrogateSelector
- ISurrogateSelector
En implementering av ISurrogateSelector.
Undantag
maxItemsInObjectGraph värdet är mindre än 0.
Exempel
I följande exempel skapas en instans av med hjälp av NetDataContractSerializer en StreamingContext. Koden anger ignoreExtensionDataObjectockså , och anger en implementering av ISurrogateSelector gränssnittet som ska hanteras för att hjälpa serialiseraren när du väljer en surrogat (för att deserialisera äldre typer).
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
Kommentarer
Parametern ignoreExtensionDataObject används när IExtensibleDataObject gränssnittet implementeras i klassen som serialiseras eller deserialiseras.
Gäller för
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initierar en ny instans av NetDataContractSerializer klassen med angivna kontextdata och rotnamn och namnområde. Dessutom anger det maximala antalet objekt i objektet som ska serialiseras och parametrar för att ange om extra data ignoreras, metoden för sammansättningsinläsning och en surrogatväljare.
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)
Parametrar
- rootName
- String
Namnet på XML-elementet som omger innehållet för att serialisera eller deserialisera.
- rootNamespace
- String
Namnområdet för XML-elementet som omger innehållet för att serialisera eller deserialisera.
- context
- StreamingContext
En StreamingContext som innehåller kontextdata.
- maxItemsInObjectGraph
- Int32
Det maximala antalet objekt i diagrammet som ska serialiseras eller deserialiseras.
- ignoreExtensionDataObject
- Boolean
trueför att ignorera de data som tillhandahålls av ett tillägg av typen; annars . false
- assemblyFormat
- FormatterAssemblyStyle
Ett FormatterAssemblyStyle uppräkningsvärde som anger en metod för att hitta och läsa in sammansättningar.
- surrogateSelector
- ISurrogateSelector
En implementering av IDataContractSurrogate för att hantera den äldre typen.
Undantag
maxItemsInObjectGraph värdet är mindre än 0.
Exempel
I följande exempel skapas en instans av NetDataContractSerializer det xml-elementnamn och namnområde som ska förväntas vid deserialisering. Koden anger ignoreExtensionDataObjectockså , och anger en implementering av ISurrogateSelector gränssnittet som ska hanteras för att hjälpa serialiseraren när du väljer en surrogat (för att deserialisera äldre typer).
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
Kommentarer
Parametern ignoreExtensionDataObject används när IExtensibleDataObject gränssnittet implementeras i klassen som serialiseras eller deserialiseras.
Gäller för
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initierar en ny instans av NetDataContractSerializer klassen med angivna kontextdata och rotnamn och namnområde (som XmlDictionaryString parametrar), anger dessutom det maximala antalet objekt i objektet som ska serialiseras och parametrar för att ange om extra data som hittas ignoreras, metoden för inläsning av sammansättning och en surrogatväljare.
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)
Parametrar
- rootName
- XmlDictionaryString
En XmlDictionaryString som innehåller rotelementet i innehållet.
- rootNamespace
- XmlDictionaryString
En XmlDictionaryString som innehåller rotelementets namnområde.
- context
- StreamingContext
En StreamingContext som innehåller kontextdata.
- maxItemsInObjectGraph
- Int32
Det maximala antalet objekt i diagrammet som ska serialiseras eller deserialiseras.
- ignoreExtensionDataObject
- Boolean
trueför att ignorera de data som tillhandahålls av ett tillägg av typen; annars . false
- assemblyFormat
- FormatterAssemblyStyle
Ett FormatterAssemblyStyle uppräkningsvärde som anger en metod för att hitta och läsa in sammansättningar.
- surrogateSelector
- ISurrogateSelector
En implementering av IDataContractSurrogate för att hantera den äldre typen.
Undantag
maxItemsInObjectGraph värdet är mindre än 0.
Exempel
I följande exempel skapas en instans av NetDataContractSerializer det xml-elementnamn och namnområde (som argument) som XmlDictionaryString ska förväntas vid deserialisering. Koden anger ignoreExtensionDataObjectockså , och anger en implementering av ISurrogateSelector gränssnittet som ska hanteras för att hjälpa serialiseraren när du väljer en surrogat (för att deserialisera äldre typer).
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
Kommentarer
XmlDictionaryString Kan användas för att optimera prestanda när samma uppsättning strängar används mellan objektinstanser.
Parametern ignoreExtensionDataObject används när IExtensibleDataObject gränssnittet implementeras i klassen som serialiseras eller deserialiseras.