NetDataContractSerializer Konstruktorer

Definition

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.

Gäller för