NetDataContractSerializer Konstruktor
Definisi
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 NetDataContractSerializerStreamingContext.
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
maxItemsInObjectGraph
nilainya kurang dari 0.
Contoh
Contoh berikut membuat instans menggunakan NetDataContractSerializerStreamingContext. 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
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
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.