NetDataContractSerializer Konstruktorok

Definíció

Névtér:: System.Runtime.Serialization

Szerelvény:: System.Runtime.Serialization.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Inicializálja a NetDataContractSerializer osztály új példányát.

Túlterhelések

Name	Description
NetDataContractSerializer()	Inicializálja a NetDataContractSerializer osztály új példányát.
NetDataContractSerializer(StreamingContext)	Inicializálja az NetDataContractSerializer osztály új példányát a megadott streamkörnyezeti adatokkal.
NetDataContractSerializer(String, String)	Inicializálja az osztály új példányát a NetDataContractSerializer megadott XML-gyökérelemmel és névtérrel.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	Inicializálja az NetDataContractSerializer osztály új példányát két olyan típusú XmlDictionaryString paraméterrel, amelyek tartalmazzák a tartalom megadásához használt gyökérelemet és névteret.
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicializálja az NetDataContractSerializer osztály új példányát a megadott környezeti adatokkal; emellett megadja a szerializálni kívánt objektum elemeinek maximális számát, valamint a paramétereket, amelyek megadják, hogy a rendszer figyelmen kívül hagyja-e a további adatokat, a szerelvénybetöltési módszert és a helyettesítő választót.
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicializálja az NetDataContractSerializer osztály új példányát a megadott környezeti adatokkal, gyökérnévvel és névtérrel; emellett megadja a szerializálni kívánt objektum elemeinek maximális számát, valamint a paramétereket, amelyek meghatározzák, hogy a rendszer figyelmen kívül hagyja-e a további adatokat, a szerelvény betöltési módszerét és a helyettesítő választót.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicializálja az NetDataContractSerializer osztály új példányát a megadott környezeti adatokkal, valamint a gyökérnevet és a névteret (paraméterként XmlDictionaryString ); emellett megadja a szerializálni kívánt objektum elemeinek maximális számát, valamint a paramétereket, amelyek meghatározzák, hogy a rendszer figyelmen kívül hagyja-e a talált extra adatokat, a szerelvénybetöltési módszert és a helyettesítő választót.

NetDataContractSerializer()

Inicializálja a NetDataContractSerializer osztály új példányát.

public:
 NetDataContractSerializer();

public NetDataContractSerializer();

Public Sub New ()

Példák

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.

A következőre érvényes:

NetDataContractSerializer(StreamingContext)

Inicializálja az NetDataContractSerializer osztály új példányát a megadott streamkörnyezeti adatokkal.

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)

Paraméterek

context: StreamingContext

A StreamingContext környezeti adatokat tartalmazó.

Példák

Az alábbi példa létrehoz egy példányt a NetDataContractSerializer using a 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

Megjegyzések

Az StreamingContext osztály lehetővé teszi az objektumok olvasása és írása során használandó, felhasználóspecifikus környezeti adatok átadását.

A következőre érvényes:

NetDataContractSerializer(String, String)

Inicializálja az osztály új példányát a NetDataContractSerializer megadott XML-gyökérelemmel és névtérrel.

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)

Paraméterek

rootName: String

Annak az XML-elemnek a neve, amely a tartalmat szerializálni vagy deszerializálni kívánja.

rootNamespace: String

Annak az XML-elemnek a névtere, amely a tartalmat szerializálni vagy deszerializálni kívánja.

Példák

Az alábbi példa létrehozza annak az XML-gyökérelemnek és névtérnek a DataContractSerializer példányát, amely az objektum deszerializálása során várható.

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

A következőre érvényes:

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Inicializálja az NetDataContractSerializer osztály új példányát két olyan típusú XmlDictionaryString paraméterrel, amelyek tartalmazzák a tartalom megadásához használt gyökérelemet és névteret.

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)

Paraméterek

rootName: XmlDictionaryString

Annak XmlDictionaryString az XML-elemnek a nevét tartalmazza, amely a tartalmat szerializálni vagy deszerializálni kívánja.

rootNamespace: XmlDictionaryString

Az XmlDictionaryString XML-elem névterét tartalmazza, amely a tartalmat szerializálni vagy deszerializálni kívánja.

Példák

Az alábbi példa létrehoz egy példányt annak az DataContractSerializer XML-gyökérelemnek és névtérnek (argumentumként XmlDictionaryString ) megadásával, amely az objektum deszerializálása során várható.

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

Megjegyzések

Ez XmlDictionaryString használható a teljesítmény optimalizálására, ha ugyanazt a sztringkészletet használják az objektumpéldányok között.

A következőre érvényes:

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

Inicializálja az NetDataContractSerializer osztály új példányát a megadott környezeti adatokkal; emellett megadja a szerializálni kívánt objektum elemeinek maximális számát, valamint a paramétereket, amelyek megadják, hogy a rendszer figyelmen kívül hagyja-e a további adatokat, a szerelvénybetöltési módszert és a helyettesítő választót.

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)

Paraméterek

context: StreamingContext

A StreamingContext környezeti adatokat tartalmazó.

maxItemsInObjectGraph: Int32

A gráf azon elemeinek maximális száma, amelyek szerializálhatók vagy deszerializálhatók.

ignoreExtensionDataObject: Boolean

truea típus kiterjesztése által szolgáltatott adatok figyelmen kívül hagyása; egyéb esetben. false

assemblyFormat: FormatterAssemblyStyle

Enumerálási FormatterAssemblyStyle érték, amely meghatározza a szerelvények helyének és betöltésének módját.

surrogateSelector: ISurrogateSelector

A .ISurrogateSelector

Kivételek

ArgumentOutOfRangeException

maxItemsInObjectGraph értéke kisebb, mint 0.

Példák

Az alábbi példa létrehoz egy példányt a NetDataContractSerializer using a StreamingContext. A kód beállítja a ignoreExtensionDataObjectkezelőfelület implementációját ISurrogateSelector is, amely segít a szerializálónak helyettes kiválasztásakor (az örökölt típusok deszerializálásához).

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

Megjegyzések

A ignoreExtensionDataObject paraméter akkor használatos, ha a IExtensibleDataObject felület a szerializált vagy deszerializált osztályban van implementálva.

A következőre érvényes:

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

Inicializálja az NetDataContractSerializer osztály új példányát a megadott környezeti adatokkal, gyökérnévvel és névtérrel; emellett megadja a szerializálni kívánt objektum elemeinek maximális számát, valamint a paramétereket, amelyek meghatározzák, hogy a rendszer figyelmen kívül hagyja-e a további adatokat, a szerelvény betöltési módszerét és a helyettesítő választót.

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)

Paraméterek

rootName: String

Annak az XML-elemnek a neve, amely a tartalmat szerializálni vagy deszerializálni kívánja.

rootNamespace: String

Annak az XML-elemnek a névtere, amely a tartalmat szerializálni vagy deszerializálni kívánja.

context: StreamingContext

A StreamingContext környezeti adatokat tartalmazó.

maxItemsInObjectGraph: Int32

A gráf azon elemeinek maximális száma, amelyek szerializálhatók vagy deszerializálhatók.

ignoreExtensionDataObject: Boolean

truea típus kiterjesztése által szolgáltatott adatok figyelmen kívül hagyása; egyéb esetben. false

assemblyFormat: FormatterAssemblyStyle

Enumerálási FormatterAssemblyStyle érték, amely meghatározza a szerelvények helyének és betöltésének módját.

surrogateSelector: ISurrogateSelector

Az örökölt típus kezelésére vonatkozó implementáció IDataContractSurrogate .

Kivételek

ArgumentOutOfRangeException

maxItemsInObjectGraph értéke kisebb, mint 0.

Példák

Az alábbi példa létrehozza a NetDataContractSerializer deszerializáláskor elvárható XML-elem nevét és névterét megadó példányt. A kód beállítja a ignoreExtensionDataObjectkezelőfelület implementációját ISurrogateSelector is, amely segít a szerializálónak helyettes kiválasztásakor (az örökölt típusok deszerializálásához).

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

Megjegyzések

A ignoreExtensionDataObject paraméter akkor használatos, ha a IExtensibleDataObject felület a szerializált vagy deszerializált osztályban van implementálva.

A következőre érvényes:

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

Inicializálja az NetDataContractSerializer osztály új példányát a megadott környezeti adatokkal, valamint a gyökérnevet és a névteret (paraméterként XmlDictionaryString ); emellett megadja a szerializálni kívánt objektum elemeinek maximális számát, valamint a paramétereket, amelyek meghatározzák, hogy a rendszer figyelmen kívül hagyja-e a talált extra adatokat, a szerelvénybetöltési módszert és a helyettesítő választót.

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)

Paraméterek

rootName: XmlDictionaryString

A XmlDictionaryString tartalom gyökérelemét tartalmazó elem.

rootNamespace: XmlDictionaryString

A XmlDictionaryString gyökérelem névterét tartalmazó névtér.

context: StreamingContext

A StreamingContext környezeti adatokat tartalmazó.

maxItemsInObjectGraph: Int32

A gráf azon elemeinek maximális száma, amelyek szerializálhatók vagy deszerializálhatók.

ignoreExtensionDataObject: Boolean

truea típus kiterjesztése által szolgáltatott adatok figyelmen kívül hagyása; egyéb esetben. false

assemblyFormat: FormatterAssemblyStyle

Enumerálási FormatterAssemblyStyle érték, amely meghatározza a szerelvények helyének és betöltésének módját.

surrogateSelector: ISurrogateSelector

Az örökölt típus kezelésére vonatkozó implementáció IDataContractSurrogate .

Kivételek

ArgumentOutOfRangeException

maxItemsInObjectGraph értéke kisebb, mint 0.

Példák

Az alábbi példa létrehozza az NetDataContractSerializer XML-elem nevének és névterének (argumentumként XmlDictionaryString ) a deszerializálás során várt példányát. A kód beállítja a ignoreExtensionDataObjectkezelőfelület implementációját ISurrogateSelector is, amely segít a szerializálónak helyettes kiválasztásakor (az örökölt típusok deszerializálásához).

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

Megjegyzések

Ez XmlDictionaryString használható a teljesítmény optimalizálására, ha ugyanazt a sztringkészletet használják az objektumpéldányok között.

A ignoreExtensionDataObject paraméter akkor használatos, ha a IExtensibleDataObject felület a szerializált vagy deszerializált osztályban van implementálva.

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?