NetDataContractSerializer Konstruktory

Reference

Definice

Obor názvů:: System.Runtime.Serialization

Sestavení:: System.Runtime.Serialization.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci NetDataContractSerializer třídy.

Přetížení

NetDataContractSerializer()	Inicializuje novou instanci NetDataContractSerializer třídy.
NetDataContractSerializer(StreamingContext)	Inicializuje novou instanci NetDataContractSerializer třídy se zadanými streamovanými kontextovými daty.
NetDataContractSerializer(String, String)	Inicializuje novou instanci NetDataContractSerializer třídy se zadaným kořenovým elementem XML a oborem názvů.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	Inicializuje novou instanci NetDataContractSerializer třídy se dvěma parametry typu XmlDictionaryString , které obsahují kořenový prvek a obor názvů použitý k určení obsahu.
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicializuje novou instanci NetDataContractSerializer třídy se zadanými kontextovými daty; kromě toho určuje maximální počet položek v objektu, který má být serializován, a parametry pro určení, zda jsou nadbytečná data ignorována, metodu načítání sestavení a náhradní selektor.
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicializuje novou instanci NetDataContractSerializer třídy s zadanými kontextovými daty a kořenovým názvem a oborem názvů; kromě toho určuje maximální počet položek v objektu, který má být serializován, a parametry pro určení, zda jsou nadbytečná data ignorována, metodu načítání sestavení a náhradní selektor.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicializuje novou instanci NetDataContractSerializer třídy s zadanými kontextovými daty a kořenovým názvem a oborem názvů (jako XmlDictionaryString parametry). Kromě toho určuje maximální počet položek v objektu, který má být serializován, a parametry určující, zda jsou nadbytečná nalezená data ignorována, metodu načítání sestavení a náhradní selektor.

NetDataContractSerializer()

Inicializuje novou instanci NetDataContractSerializer třídy.

public:
 NetDataContractSerializer();

public NetDataContractSerializer ();

Public Sub New ()

Příklady

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.

Platí pro

NetDataContractSerializer(StreamingContext)

Inicializuje novou instanci NetDataContractSerializer třídy se zadanými streamovanými kontextovými daty.

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)

Parametry

context: StreamingContext

A StreamingContext , který obsahuje kontextová data.

Příklady

Následující příklad vytvoří instanci objektu NetDataContractSerializer pomocí 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

Poznámky

Třída StreamingContext umožňuje předávat kontextová data specifická pro uživatele, která se mají použít při čtení a zápisu objektů.

Platí pro

NetDataContractSerializer(String, String)

Inicializuje novou instanci NetDataContractSerializer třídy se zadaným kořenovým elementem XML a oborem názvů.

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)

Parametry

rootName: String

Název elementu XML, který uzavře obsah k serializaci nebo deserializaci.

rootNamespace: String

Obor názvů elementu XML, který uzavře obsah k serializaci nebo deserializaci.

Příklady

Následující příklad vytvoří instanci DataContractSerializer určující kořenový element XML a obor názvů, který očekává při deserializaci objektu.

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

Platí pro

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Inicializuje novou instanci NetDataContractSerializer třídy se dvěma parametry typu XmlDictionaryString , které obsahují kořenový prvek a obor názvů použitý k určení obsahu.

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)

Parametry

rootName: XmlDictionaryString

Obsahuje XmlDictionaryString název xml elementu, který obklopuje obsah serializovat nebo deserializovat.

rootNamespace: XmlDictionaryString

Obsahuje XmlDictionaryString obor názvů elementu XML, který obklopuje obsah serializovat nebo deserializovat.

Příklady

Následující příklad vytvoří instanci DataContractSerializer určující kořenový element XML a obor názvů (jako XmlDictionaryString argumenty) bude očekávat při deserializaci objektu.

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

Poznámky

Nástroj XmlDictionaryString lze použít k optimalizaci výkonu, pokud se stejná sada řetězců používá napříč instancemi objektů.

Platí pro

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

Inicializuje novou instanci NetDataContractSerializer třídy se zadanými kontextovými daty; kromě toho určuje maximální počet položek v objektu, který má být serializován, a parametry pro určení, zda jsou nadbytečná data ignorována, metodu načítání sestavení a náhradní selektor.

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)

Parametry

context: StreamingContext

A StreamingContext , který obsahuje kontextová data.

maxItemsInObjectGraph: Int32

Maximální počet položek v grafu, které se mají serializovat nebo deserializovat.

ignoreExtensionDataObject: Boolean

trueignorovat údaje poskytované rozšířením typu; v opačném případě . false

assemblyFormat: FormatterAssemblyStyle

Hodnota FormatterAssemblyStyle výčtu, která určuje metodu pro vyhledání a načítání sestavení.

surrogateSelector: ISurrogateSelector

Implementace ISurrogateSelector.

Výjimky

ArgumentOutOfRangeException

maxItemsInObjectGraph hodnota je menší než 0.

Příklady

Následující příklad vytvoří instanci objektu NetDataContractSerializer pomocí StreamingContext. Kód také nastaví ignoreExtensionDataObjecta určuje implementaci ISurrogateSelector rozhraní, které se má zpracovat, aby pomohl serializátoru při výběru náhradního typu (pro deserializaci starších typů).

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

Poznámky

Parametr ignoreExtensionDataObject se používá, když IExtensibleDataObject je rozhraní implementováno ve třídě, která je serializována nebo deserializována.

Platí pro

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

Inicializuje novou instanci NetDataContractSerializer třídy s zadanými kontextovými daty a kořenovým názvem a oborem názvů; kromě toho určuje maximální počet položek v objektu, který má být serializován, a parametry pro určení, zda jsou nadbytečná data ignorována, metodu načítání sestavení a náhradní selektor.

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)

Parametry

rootName: String

Název elementu XML, který uzavře obsah k serializaci nebo deserializaci.

rootNamespace: String

Obor názvů elementu XML, který uzavře obsah k serializaci nebo deserializaci.

context: StreamingContext

A StreamingContext , který obsahuje kontextová data.

maxItemsInObjectGraph: Int32

Maximální počet položek v grafu, které se mají serializovat nebo deserializovat.

ignoreExtensionDataObject: Boolean

trueignorovat údaje poskytované rozšířením typu; v opačném případě . false

assemblyFormat: FormatterAssemblyStyle

Hodnota FormatterAssemblyStyle výčtu, která určuje metodu pro vyhledání a načítání sestavení.

surrogateSelector: ISurrogateSelector

Implementace pro IDataContractSurrogate zpracování staršího typu.

Výjimky

ArgumentOutOfRangeException

maxItemsInObjectGraph hodnota je menší než 0.

Příklady

Následující příklad vytvoří instanci NetDataContractSerializer určující název a obor názvů elementu XML, který se očekává při deserializaci. Kód také nastaví ignoreExtensionDataObjecta určuje implementaci ISurrogateSelector rozhraní, které se má zpracovat, aby pomohl serializátoru při výběru náhradního typu (pro deserializaci starších typů).

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

Poznámky

Parametr ignoreExtensionDataObject se používá, když IExtensibleDataObject je rozhraní implementováno ve třídě, která je serializována nebo deserializována.

Platí pro

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

Inicializuje novou instanci NetDataContractSerializer třídy s zadanými kontextovými daty a kořenovým názvem a oborem názvů (jako XmlDictionaryString parametry). Kromě toho určuje maximální počet položek v objektu, který má být serializován, a parametry určující, zda jsou nadbytečná nalezená data ignorována, metodu načítání sestavení a náhradní selektor.

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)

Parametry

rootName: XmlDictionaryString

Objekt XmlDictionaryString , který obsahuje kořenový prvek obsahu.

rootNamespace: XmlDictionaryString

Objekt XmlDictionaryString , který obsahuje obor názvů kořenového elementu.

context: StreamingContext

A StreamingContext , který obsahuje kontextová data.

maxItemsInObjectGraph: Int32

Maximální počet položek v grafu, které se mají serializovat nebo deserializovat.

ignoreExtensionDataObject: Boolean

trueignorovat údaje poskytované rozšířením typu; v opačném případě . false

assemblyFormat: FormatterAssemblyStyle

Hodnota FormatterAssemblyStyle výčtu, která určuje metodu pro vyhledání a načítání sestavení.

surrogateSelector: ISurrogateSelector

Implementace pro IDataContractSurrogate zpracování staršího typu.

Výjimky

ArgumentOutOfRangeException

maxItemsInObjectGraph hodnota je menší než 0.

Příklady

Následující příklad vytvoří instanci NetDataContractSerializer určující název elementu XML a obor názvů (jako XmlDictionaryString argumenty), které se mají očekávat při deserializaci. Kód také nastaví ignoreExtensionDataObjecta určuje implementaci ISurrogateSelector rozhraní, které se má zpracovat, aby pomohl serializátoru při výběru náhradního typu (pro deserializaci starších typů).

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

Poznámky

Nástroj XmlDictionaryString lze použít k optimalizaci výkonu, pokud se stejná sada řetězců používá napříč instancemi objektů.

Parametr ignoreExtensionDataObject se používá, když IExtensibleDataObject je rozhraní implementováno ve třídě, která je serializována nebo deserializována.

Platí pro

Sdílet prostřednictvím

NetDataContractSerializer Konstruktory

Definice

Přetížení

NetDataContractSerializer()

Příklady

Platí pro

NetDataContractSerializer(StreamingContext)

Parametry

Příklady

Poznámky

Platí pro

NetDataContractSerializer(String, String)

Parametry

Příklady

Platí pro

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Parametry

Příklady

Poznámky

Platí pro

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

Parametry

Výjimky

Příklady

Poznámky

Platí pro

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

Parametry

Výjimky

Příklady

Poznámky

Platí pro

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

Parametry

Výjimky

Příklady

Poznámky

Platí pro

Další materiály