NetDataContractSerializer Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse.
Overloads
| Name | Description |
|---|---|
| NetDataContractSerializer() |
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse. |
| NetDataContractSerializer(StreamingContext) |
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met de opgegeven streamingcontextgegevens. |
| NetDataContractSerializer(String, String) |
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met het opgegeven XML-hoofdelement en de naamruimte. |
| NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString) |
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met twee parameters van het type XmlDictionaryString dat het hoofdelement en de naamruimte bevatten die worden gebruikt om de inhoud op te geven. |
| NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met de opgegeven contextgegevens. Daarnaast geeft u het maximum aantal items in het object op dat moet worden geserialiseerd en parameters om op te geven of er extra gegevens worden genegeerd, de assemblylaadmethode en een surrogaatkiezer. |
| NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met de opgegeven contextgegevens en de hoofdnaam en naamruimte. Daarnaast geeft u het maximum aantal items in het object op dat moet worden geserialiseerd en parameters om op te geven of extra gegevens worden genegeerd, de assembly-laadmethode en een surrogaatselector. |
| NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector) |
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met de opgegeven contextgegevens en de hoofdnaam en naamruimte (als XmlDictionaryString parameters). Daarnaast geeft u het maximum aantal items in het object op dat moet worden geserialiseerd en parameters om op te geven of extra gegevens worden genegeerd, methode voor assembly laden en een surrogaatselector. |
NetDataContractSerializer()
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse.
public:
NetDataContractSerializer();
public NetDataContractSerializer();
Public Sub New ()
Voorbeelden
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.
Van toepassing op
NetDataContractSerializer(StreamingContext)
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met de opgegeven streamingcontextgegevens.
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)
Parameters
- context
- StreamingContext
Een StreamingContext met contextgegevens.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het NetDataContractSerializer gebruik van een 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
Opmerkingen
Met de StreamingContext klasse kunt u gebruikersspecifieke contextgegevens doorgeven die u kunt gebruiken tijdens het lezen en schrijven van objecten.
Van toepassing op
NetDataContractSerializer(String, String)
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met het opgegeven XML-hoofdelement en de naamruimte.
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)
Parameters
- rootName
- String
De naam van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- rootNamespace
- String
De naamruimte van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het opgeven van het XML-hoofdelement en de DataContractSerializer naamruimte die wordt verwacht bij het deserialiseren van een object.
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
Van toepassing op
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met twee parameters van het type XmlDictionaryString dat het hoofdelement en de naamruimte bevatten die worden gebruikt om de inhoud op te geven.
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)
Parameters
- rootName
- XmlDictionaryString
Een XmlDictionaryString met de naam van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- rootNamespace
- XmlDictionaryString
Een XmlDictionaryString met de naamruimte van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het opgeven van het DataContractSerializer XML-hoofdelement en de naamruimte (als XmlDictionaryString argumenten) die wordt verwacht wanneer een object wordt gedeserialiseerd.
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
Opmerkingen
Deze XmlDictionaryString kan worden gebruikt om de prestaties te optimaliseren wanneer dezelfde set tekenreeksen wordt gebruikt voor objectexemplaren.
Van toepassing op
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met de opgegeven contextgegevens. Daarnaast geeft u het maximum aantal items in het object op dat moet worden geserialiseerd en parameters om op te geven of er extra gegevens worden genegeerd, de assemblylaadmethode en een surrogaatkiezer.
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)
Parameters
- context
- StreamingContext
Een StreamingContext met contextgegevens.
- maxItemsInObjectGraph
- Int32
Het maximum aantal items in de grafiek dat moet worden geserialiseerd of gedeserialiseerd.
- ignoreExtensionDataObject
- Boolean
true om de gegevens die door een uitbreiding van het type worden verstrekt, te negeren; anders, false.
- assemblyFormat
- FormatterAssemblyStyle
Een FormatterAssemblyStyle opsommingswaarde die een methode opgeeft voor het zoeken en laden van assembly's.
- surrogateSelector
- ISurrogateSelector
Een implementatie van de ISurrogateSelector.
Uitzonderingen
maxItemsInObjectGraph de waarde kleiner is dan 0.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van het NetDataContractSerializer gebruik van een StreamingContext. De code stelt ook de ignoreExtensionDataObjecten geeft een implementatie van de ISurrogateSelector interface op die moet worden verwerkt om de serialisatiefunctie te helpen bij het selecteren van een surrogaat (voor het deserialiseren van verouderde typen).
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
Opmerkingen
De ignoreExtensionDataObject parameter wordt gebruikt wanneer de IExtensibleDataObject interface wordt geïmplementeerd in de klasse die wordt geserialiseerd of gedeserialiseerd.
Van toepassing op
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met de opgegeven contextgegevens en de hoofdnaam en naamruimte. Daarnaast geeft u het maximum aantal items in het object op dat moet worden geserialiseerd en parameters om op te geven of extra gegevens worden genegeerd, de assembly-laadmethode en een surrogaatselector.
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)
Parameters
- rootName
- String
De naam van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- rootNamespace
- String
De naamruimte van het XML-element waarmee de inhoud wordt geserialiseerd of gedeserialiseerd.
- context
- StreamingContext
Een StreamingContext met contextgegevens.
- maxItemsInObjectGraph
- Int32
Het maximum aantal items in de grafiek dat moet worden geserialiseerd of gedeserialiseerd.
- ignoreExtensionDataObject
- Boolean
true om de gegevens die door een uitbreiding van het type worden verstrekt, te negeren; anders, false.
- assemblyFormat
- FormatterAssemblyStyle
Een FormatterAssemblyStyle opsommingswaarde die een methode opgeeft voor het zoeken en laden van assembly's.
- surrogateSelector
- ISurrogateSelector
Een implementatie van het IDataContractSurrogate type voor het afhandelen van het verouderde type.
Uitzonderingen
maxItemsInObjectGraph de waarde kleiner is dan 0.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van de NetDataContractSerializer naam van het XML-element en de naamruimte die u kunt verwachten bij het deserialiseren. De code stelt ook de ignoreExtensionDataObjecten geeft een implementatie van de ISurrogateSelector interface op die moet worden verwerkt om de serialisatiefunctie te helpen bij het selecteren van een surrogaat (voor het deserialiseren van verouderde typen).
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
Opmerkingen
De ignoreExtensionDataObject parameter wordt gebruikt wanneer de IExtensibleDataObject interface wordt geïmplementeerd in de klasse die wordt geserialiseerd of gedeserialiseerd.
Van toepassing op
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)
Initialiseert een nieuw exemplaar van de NetDataContractSerializer klasse met de opgegeven contextgegevens en de hoofdnaam en naamruimte (als XmlDictionaryString parameters). Daarnaast geeft u het maximum aantal items in het object op dat moet worden geserialiseerd en parameters om op te geven of extra gegevens worden genegeerd, methode voor assembly laden en een surrogaatselector.
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)
Parameters
- rootName
- XmlDictionaryString
Een XmlDictionaryString met het hoofdelement van de inhoud.
- rootNamespace
- XmlDictionaryString
Een XmlDictionaryString met de naamruimte van het hoofdelement.
- context
- StreamingContext
Een StreamingContext met contextgegevens.
- maxItemsInObjectGraph
- Int32
Het maximum aantal items in de grafiek dat moet worden geserialiseerd of gedeserialiseerd.
- ignoreExtensionDataObject
- Boolean
true om de gegevens die door een uitbreiding van het type worden verstrekt, te negeren; anders, false.
- assemblyFormat
- FormatterAssemblyStyle
Een FormatterAssemblyStyle opsommingswaarde die een methode opgeeft voor het zoeken en laden van assembly's.
- surrogateSelector
- ISurrogateSelector
Een implementatie van het IDataContractSurrogate type voor het afhandelen van het verouderde type.
Uitzonderingen
maxItemsInObjectGraph de waarde kleiner is dan 0.
Voorbeelden
In het volgende voorbeeld wordt een exemplaar gemaakt van de NetDataContractSerializer naam van het XML-element en de naamruimte (als XmlDictionaryString argumenten) die u kunt verwachten bij het deserialisatieproces. De code stelt ook de ignoreExtensionDataObjecten geeft een implementatie van de ISurrogateSelector interface op die moet worden verwerkt om de serialisatiefunctie te helpen bij het selecteren van een surrogaat (voor het deserialiseren van verouderde typen).
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
Opmerkingen
Deze XmlDictionaryString kan worden gebruikt om de prestaties te optimaliseren wanneer dezelfde set tekenreeksen wordt gebruikt voor objectexemplaren.
De ignoreExtensionDataObject parameter wordt gebruikt wanneer de IExtensibleDataObject interface wordt geïmplementeerd in de klasse die wordt geserialiseerd of gedeserialiseerd.