NetDataContractSerializer Konstruktor

Referensi

Definisi

Ruang nama:: System.Runtime.Serialization

Rakitan:: System.Runtime.Serialization.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menginisialisasi instans baru kelas NetDataContractSerializer.

Overload

NetDataContractSerializer()	Menginisialisasi instans baru kelas NetDataContractSerializer.
NetDataContractSerializer(StreamingContext)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks streaming yang disediakan.
NetDataContractSerializer(String, String)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan elemen akar XML dan namespace yang disediakan.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan dua parameter jenis XmlDictionaryString yang berisi elemen akar dan namespace layanan yang digunakan untuk menentukan konten.
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks yang disediakan; selain itu, menentukan jumlah maksimum item dalam objek yang akan diserialisasikan, dan parameter untuk menentukan apakah data tambahan diabaikan, metode pemuatan rakitan, dan pemilih pengganti.
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks yang disediakan dan nama akar dan namespace layanan; selain itu, menentukan jumlah maksimum item dalam objek yang akan diserialisasikan, dan parameter untuk menentukan apakah data tambahan diabaikan, metode pemuatan rakitan, dan pemilih pengganti.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks yang disediakan, dan nama akar dan namespace layanan (sebagai XmlDictionaryString parameter); selain itu, menentukan jumlah maksimum item dalam objek yang akan diserialisasikan, dan parameter untuk menentukan apakah data tambahan yang ditemukan diabaikan, metode pemuatan rakitan, dan pemilih pengganti.

NetDataContractSerializer()

Menginisialisasi instans baru kelas NetDataContractSerializer.

public:
 NetDataContractSerializer();

public NetDataContractSerializer ();

Public Sub New ()

Contoh

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.

Berlaku untuk

NetDataContractSerializer(StreamingContext)

Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks streaming yang disediakan.

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)

Parameter

context: StreamingContext

StreamingContext yang berisi data konteks.

Contoh

Contoh berikut membuat instans menggunakan NetDataContractSerializer 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

Keterangan

Kelas ini StreamingContext memungkinkan Anda untuk meneruskan data konteks khusus pengguna untuk digunakan saat membaca dan menulis objek.

Berlaku untuk

NetDataContractSerializer(String, String)

Menginisialisasi instans NetDataContractSerializer baru kelas dengan elemen akar XML dan namespace yang disediakan.

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)

Parameter

rootName: String

Nama elemen XML yang menyertakan konten untuk diserialisasikan atau deserialisasi.

rootNamespace: String

Namespace elemen XML yang menyertakan konten untuk diserialisasikan atau deserialisasi.

Contoh

Contoh berikut membuat instans dari DataContractSerializer menentukan elemen akar XML dan namespace layanan yang akan diharapkan saat mendeserialisasi objek.

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

Berlaku untuk

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Menginisialisasi instans NetDataContractSerializer baru kelas dengan dua parameter jenis XmlDictionaryString yang berisi elemen akar dan namespace layanan yang digunakan untuk menentukan konten.

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)

Parameter

rootName: XmlDictionaryString

yang XmlDictionaryString berisi nama elemen XML yang menyertakan konten untuk diserialisasikan atau deserialisasi.

rootNamespace: XmlDictionaryString

XmlDictionaryString Yang berisi namespace elemen XML yang menyertakan konten untuk diserialisasikan atau deserialisasi.

Contoh

Contoh berikut membuat instans dari DataContractSerializer menentukan elemen akar XML dan namespace (sebagai XmlDictionaryString argumen) yang akan diharapkan saat mendeserialisasi objek.

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

Keterangan

XmlDictionaryString dapat digunakan untuk mengoptimalkan performa ketika serangkaian string yang sama digunakan di seluruh instans objek.

Berlaku untuk

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

Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks yang disediakan; selain itu, menentukan jumlah maksimum item dalam objek yang akan diserialisasikan, dan parameter untuk menentukan apakah data tambahan diabaikan, metode pemuatan rakitan, dan pemilih pengganti.

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)

Parameter

context: StreamingContext

StreamingContext yang berisi data konteks.

maxItemsInObjectGraph: Int32

Jumlah maksimum item dalam grafik untuk diserialisasikan atau deserialisasi.

ignoreExtensionDataObject: Boolean

true untuk mengabaikan data yang disediakan oleh ekstensi jenis; jika tidak, false.

assemblyFormat: FormatterAssemblyStyle

Nilai FormatterAssemblyStyle enumerasi yang menentukan metode untuk menemukan dan memuat rakitan.

surrogateSelector: ISurrogateSelector

Implementasi dari ISurrogateSelector.

Pengecualian

ArgumentOutOfRangeException

maxItemsInObjectGraph nilainya kurang dari 0.

Contoh

Contoh berikut membuat instans menggunakan NetDataContractSerializer StreamingContext. Kode ini juga mengatur ignoreExtensionDataObject, dan menentukan implementasi antarmuka yang akan ditangani ISurrogateSelector untuk membantu serializer saat memilih pengganti (untuk deserialisasi jenis warisan).

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

Keterangan

Parameter ignoreExtensionDataObject digunakan saat IExtensibleDataObject antarmuka diimplementasikan di kelas yang sedang diserialisasikan atau dideserialisasi.

Berlaku untuk

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

Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks yang disediakan dan nama akar dan namespace layanan; selain itu, menentukan jumlah maksimum item dalam objek yang akan diserialisasikan, dan parameter untuk menentukan apakah data tambahan diabaikan, metode pemuatan rakitan, dan pemilih pengganti.

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)

Parameter

rootName: String

Nama elemen XML yang menyertakan konten untuk diserialisasikan atau deserialisasi.

rootNamespace: String

Namespace elemen XML yang menyertakan konten untuk diserialisasikan atau deserialisasi.

context: StreamingContext

StreamingContext yang berisi data konteks.

maxItemsInObjectGraph: Int32

Jumlah maksimum item dalam grafik untuk diserialisasikan atau deserialisasi.

ignoreExtensionDataObject: Boolean

true untuk mengabaikan data yang disediakan oleh ekstensi jenis; jika tidak, false.

assemblyFormat: FormatterAssemblyStyle

Nilai FormatterAssemblyStyle enumerasi yang menentukan metode untuk menemukan dan memuat rakitan.

surrogateSelector: ISurrogateSelector

Implementasi IDataContractSurrogate untuk menangani jenis warisan.

Pengecualian

ArgumentOutOfRangeException

maxItemsInObjectGraph nilainya kurang dari 0.

Contoh

Contoh berikut membuat instans menentukan NetDataContractSerializer nama elemen XML dan namespace layanan yang diharapkan saat deserialisasi. Kode ini juga mengatur ignoreExtensionDataObject, dan menentukan implementasi antarmuka yang akan ditangani ISurrogateSelector untuk membantu serializer saat memilih pengganti (untuk deserialisasi jenis warisan).

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

Keterangan

Parameter ignoreExtensionDataObject digunakan saat IExtensibleDataObject antarmuka diimplementasikan di kelas yang sedang diserialisasikan atau dideserialisasi.

Berlaku untuk

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

Menginisialisasi instans NetDataContractSerializer baru kelas dengan data konteks yang disediakan, dan nama akar dan namespace layanan (sebagai XmlDictionaryString parameter); selain itu, menentukan jumlah maksimum item dalam objek yang akan diserialisasikan, dan parameter untuk menentukan apakah data tambahan yang ditemukan diabaikan, metode pemuatan rakitan, dan pemilih pengganti.

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)

Parameter

rootName: XmlDictionaryString

yang XmlDictionaryString berisi elemen akar konten.

rootNamespace: XmlDictionaryString

Yang XmlDictionaryString berisi namespace elemen akar.

context: StreamingContext

StreamingContext yang berisi data konteks.

maxItemsInObjectGraph: Int32

Jumlah maksimum item dalam grafik untuk diserialisasikan atau deserialisasi.

ignoreExtensionDataObject: Boolean

true untuk mengabaikan data yang disediakan oleh ekstensi jenis; jika tidak, false.

assemblyFormat: FormatterAssemblyStyle

Nilai FormatterAssemblyStyle enumerasi yang menentukan metode untuk menemukan dan memuat rakitan.

surrogateSelector: ISurrogateSelector

Implementasi IDataContractSurrogate untuk menangani jenis warisan.

Pengecualian

ArgumentOutOfRangeException

maxItemsInObjectGraph nilainya kurang dari 0.

Contoh

Contoh berikut membuat instans NetDataContractSerializer menentukan nama elemen XML dan namespace (sebagai XmlDictionaryString argumen) yang diharapkan saat deserialisasi. Kode ini juga mengatur ignoreExtensionDataObject, dan menentukan implementasi antarmuka yang akan ditangani ISurrogateSelector untuk membantu serializer saat memilih pengganti (untuk deserialisasi jenis warisan).

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

Keterangan

XmlDictionaryString dapat digunakan untuk mengoptimalkan performa ketika serangkaian string yang sama digunakan di seluruh instans objek.

Parameter ignoreExtensionDataObject digunakan saat IExtensibleDataObject antarmuka diimplementasikan di kelas yang sedang diserialisasikan atau dideserialisasi.

Berlaku untuk

Bagikan melalui

NetDataContractSerializer Konstruktor

Definisi

Overload

NetDataContractSerializer()

Contoh

Berlaku untuk

NetDataContractSerializer(StreamingContext)

Parameter

Contoh

Keterangan

Berlaku untuk

NetDataContractSerializer(String, String)

Parameter

Contoh

Berlaku untuk

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Parameter

Contoh

Keterangan

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: