DataContractSerializer 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 DataContractSerializer.
Overload
DataContractSerializer(Type) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. |
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data tak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, pengganti untuk serialisasi kustom, parameter XmlDictionaryString yang menentukan elemen XML dan namespace yang berisi konten, dan alternatif untuk deklarasi pemetaan |
DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data yang tidak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, pengganti untuk serialisasi kustom, elemen XML dan namespace yang berisi konten, dan alternatif untuk deklarasi pemetaan |
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data tak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, pengganti untuk serialisasi kustom, dan parameter XmlDictionaryString yang menentukan elemen XML dan namespace yang berisi konten. |
DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data yang tidak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, pengganti untuk serialisasi kustom, dan elemen XML dan namespace yang berisi konten. |
DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data tak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, dan pengganti untuk serialisasi kustom. |
DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data tak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, pengganti serialisasi kustom, dan alternatif untuk memetakan |
DataContractSerializer(Type, String, String, IEnumerable<Type>) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan elemen XML akar dan namespace dalam dua parameter string serta daftar jenis yang diketahui yang mungkin ada dalam grafik objek. |
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString) |
Menginisialisasi instans DataContractSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis yang ditentukan menggunakan elemen akar XML dan namespace yang ditentukan melalui parameter jenis XmlDictionaryString. |
DataContractSerializer(Type, String, String) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan menggunakan elemen akar XML dan namespace yang disediakan. |
DataContractSerializer(Type, DataContractSerializerSettings) |
Menginisialisasi instans DataContractSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis dan pengaturan yang ditentukan. |
DataContractSerializer(Type, IEnumerable<Type>) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan, dan kumpulan jenis yang diketahui yang mungkin ada dalam grafik objek. |
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>) |
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan elemen XML akar dan namespace dalam dua XmlDictionaryString parameter serta daftar jenis yang diketahui yang mungkin ada dalam grafik objek. |
DataContractSerializer(Type)
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan.
public:
DataContractSerializer(Type ^ type);
public DataContractSerializer (Type type);
new System.Runtime.Serialization.DataContractSerializer : Type -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type)
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
Contoh
Contoh berikut membuat instans DataContractSerializer yang menentukan jenis untuk membuat serialisasi atau deserialisasi.
public static void Constructor1()
{
// Create an instance of the DataContractSerializer.
DataContractSerializer ser =
new DataContractSerializer(typeof(Person));
// Other code not shown.
}
Public Shared Sub Constructor1()
' Create an instance of the DataContractSerializer.
Dim ser As New DataContractSerializer(GetType(Person))
' Other code not shown.
End Sub
Berlaku untuk
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data tak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, pengganti untuk serialisasi kustom, parameter XmlDictionaryString yang menentukan elemen XML dan namespace yang berisi konten, dan alternatif untuk deklarasi pemetaan xsi:type
pada durasi.
public:
DataContractSerializer(Type ^ type, System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate, System::Runtime::Serialization::DataContractResolver ^ dataContractResolver);
public DataContractSerializer (Type type, System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate, System.Runtime.Serialization.DataContractResolver dataContractResolver);
new System.Runtime.Serialization.DataContractSerializer : Type * System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate * System.Runtime.Serialization.DataContractResolver -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate, dataContractResolver As DataContractResolver)
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- rootName
- XmlDictionaryString
Elemen XML yang menyertakan konten untuk diserialisasikan atau dideserialisasi.
- rootNamespace
- XmlDictionaryString
Namespace elemen XML yang menyertakan konten untuk diserialisasikan atau deserialisasi.
- knownTypes
- IEnumerable<Type>
Dari IEnumerable<T> yang Type berisi jenis yang diketahui yang mungkin ada dalam grafik objek.
- maxItemsInObjectGraph
- Int32
Jumlah maksimum item dalam grafik untuk diserialisasikan atau deserialisasi.
- ignoreExtensionDataObject
- Boolean
true
untuk mengabaikan data yang disediakan oleh ekstensi jenis setelah serialisasi dan deserialisasi; jika tidak, false
.
- preserveObjectReferences
- Boolean
true
untuk menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek; jika tidak, false
.
- dataContractSurrogate
- IDataContractSurrogate
Implementasi IDataContractSurrogate untuk menyesuaikan proses serialisasi.
- dataContractResolver
- DataContractResolver
Implementasi untuk DataContractResolver memetakan xsi:type
deklarasi ke jenis kontrak data.
Berlaku untuk
DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data yang tidak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, pengganti untuk serialisasi kustom, elemen XML dan namespace yang berisi konten, dan alternatif untuk deklarasi pemetaan xsi:type
pada durasi.
public:
DataContractSerializer(Type ^ type, System::String ^ rootName, System::String ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate, System::Runtime::Serialization::DataContractResolver ^ dataContractResolver);
public DataContractSerializer (Type type, string rootName, string rootNamespace, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate, System.Runtime.Serialization.DataContractResolver dataContractResolver);
new System.Runtime.Serialization.DataContractSerializer : Type * string * string * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate * System.Runtime.Serialization.DataContractResolver -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As String, rootNamespace As String, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate, dataContractResolver As DataContractResolver)
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- rootName
- String
Elemen XML yang menyertakan konten untuk diserialisasikan atau dideserialisasi.
- rootNamespace
- String
Namespace elemen XML yang menyertakan konten untuk diserialisasikan atau deserialisasi.
- knownTypes
- IEnumerable<Type>
Dari IEnumerable<T> yang Type berisi jenis yang diketahui yang mungkin ada dalam grafik objek.
- maxItemsInObjectGraph
- Int32
Jumlah maksimum item dalam grafik untuk diserialisasikan atau deserialisasi.
- ignoreExtensionDataObject
- Boolean
true
untuk mengabaikan data yang disediakan oleh ekstensi jenis setelah serialisasi dan deserialisasi; jika tidak, false
.
- preserveObjectReferences
- Boolean
true
untuk menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek; jika tidak, false
.
- dataContractSurrogate
- IDataContractSurrogate
Implementasi IDataContractSurrogate untuk menyesuaikan proses serialisasi.
- dataContractResolver
- DataContractResolver
Implementasi untuk DataContractResolver memetakan xsi:type
deklarasi ke jenis kontrak data.
Berlaku untuk
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data tak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, pengganti untuk serialisasi kustom, dan parameter XmlDictionaryString yang menentukan elemen XML dan namespace yang berisi konten.
public:
DataContractSerializer(Type ^ type, System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate);
public DataContractSerializer (Type type, System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate);
new System.Runtime.Serialization.DataContractSerializer : Type * System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate)
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- rootName
- XmlDictionaryString
XmlDictionaryString yang menentukan elemen XML yang menyertakan konten untuk diserialisasikan atau deserialisasi.
- rootNamespace
- XmlDictionaryString
XmlDictionaryString yang menentukan namespace XML akar.
- knownTypes
- IEnumerable<Type>
IEnumerable<T> Dari Type yang berisi jenis yang diketahui yang mungkin ada dalam grafik objek.
- maxItemsInObjectGraph
- Int32
Jumlah maksimum item dalam grafik untuk diserialisasikan atau deserialisasi.
- ignoreExtensionDataObject
- Boolean
true
untuk mengabaikan data yang disediakan oleh ekstensi jenis setelah serialisasi dan deserialisasi; jika tidak, false
.
- preserveObjectReferences
- Boolean
true
untuk menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek; jika tidak, false
.
- dataContractSurrogate
- IDataContractSurrogate
Implementasi IDataContractSurrogate untuk menyesuaikan proses serialisasi.
Pengecualian
Jumlah item melebihi nilai maksimum.
Contoh
Contoh berikut membuat instans DataContractSerializer yang menentukan jenis untuk membuat serialisasi atau deserialisasi, elemen XML akar dan namespace (sebagai XmlDictionaryString parameter), dan instans IEnumerable<T> yang berisi jenis yang digunakan selama deserialisasi. Kode ini juga mengatur ignoreExtensionDataObject
parameter dan preserveObjectReferences
ke true
, dan menentukan implementasi IDataContractSurrogate antarmuka untuk menangani jenis warisan (jenis yang tidak memiliki DataContractAttribute atribut yang diterapkan). Untuk informasi selengkapnya, lihat IDataContractSurrogate dokumentasi.
public static void Constructor9()
{
// Create a generic List of types and add the known types
// to the collection.
List<Type> knownTypeList = new List<Type>();
knownTypeList.Add(typeof(PurchaseOrder));
knownTypeList.Add(typeof(PurchaseOrderV3));
// 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 IDataContractSurrogate interface.
// The implementation code is not shown here.
DCSurrogate mySurrogate = new DCSurrogate();
DataContractSerializer ser =
new DataContractSerializer(
typeof(Person),
name_value,
ns_value,
knownTypeList,
64 * 1024,
true,
true,
mySurrogate);
// Other code not shown.
}
Public Shared Sub Constructor9()
' Create a generic List of types and add the known types
' to the collection.
Dim knownTypeList As New List(Of Type)
knownTypeList.Add(GetType(PurchaseOrder))
knownTypeList.Add(GetType(PurchaseOrderV3))
' 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 IDataContractSurrogate interface.
' The implementation code is not shown here.
Dim mySurrogate As New DCSurrogate()
Dim ser As New DataContractSerializer(GetType(Person), _
name_value, _
ns_value, _
knownTypeList, _
64 * 1064, _
True, _
True, _
mySurrogate)
' Other code not shown.
End Sub
Lihat juga
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- IDataContractSurrogate
Berlaku untuk
DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data yang tidak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, pengganti untuk serialisasi kustom, dan elemen XML dan namespace yang berisi konten.
public:
DataContractSerializer(Type ^ type, System::String ^ rootName, System::String ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate);
public DataContractSerializer (Type type, string rootName, string rootNamespace, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate);
new System.Runtime.Serialization.DataContractSerializer : Type * string * string * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As String, rootNamespace As String, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate)
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- rootName
- String
Elemen XML yang menyertakan konten untuk diserialisasikan atau dideserialisasi.
- rootNamespace
- String
Namespace elemen XML yang menyertakan konten untuk diserialisasikan atau deserialisasi.
- knownTypes
- IEnumerable<Type>
Dari IEnumerable<T> yang Type berisi jenis yang diketahui yang mungkin ada dalam grafik objek.
- maxItemsInObjectGraph
- Int32
Jumlah maksimum item dalam grafik untuk diserialisasikan atau deserialisasi.
- ignoreExtensionDataObject
- Boolean
true
untuk mengabaikan data yang disediakan oleh ekstensi jenis setelah serialisasi dan deserialisasi; jika tidak, false
.
- preserveObjectReferences
- Boolean
true
untuk menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek; jika tidak, false
.
- dataContractSurrogate
- IDataContractSurrogate
Implementasi IDataContractSurrogate untuk menyesuaikan proses serialisasi.
Pengecualian
Jumlah item melebihi nilai maksimum.
Contoh
Contoh berikut membuat instans DataContractSerializer yang menentukan jenis untuk membuat serialisasi atau deserialisasi, elemen XML akar dan namespace, dan instans IEnumerable<T> yang berisi jenis yang digunakan selama deserialisasi. Kode ini juga mengatur ignoreExtensionDataObject
parameter dan preserveObjectReferences
ke true
, dan menentukan implementasi IDataContractSurrogate antarmuka untuk menangani jenis warisan (jenis yang tidak memiliki DataContractAttribute atribut yang diterapkan). Untuk informasi selengkapnya, lihat IDataContractSurrogate dokumentasi.
public static void Constructor8()
{
// Create a generic List of types and add the known types
// to the collection.
List<Type> knownTypeList = new List<Type>();
knownTypeList.Add(typeof(PurchaseOrder));
knownTypeList.Add(typeof(PurchaseOrderV3));
// Create an instance of a class that
// implements the IDataContractSurrogate interface.
// The implementation code is not shown here.
DCSurrogate mySurrogate = new DCSurrogate();
DataContractSerializer ser =
new DataContractSerializer(
typeof(Person),
"Customer",
@"http://www.contoso.com",
knownTypeList,
64 * 1024,
true,
true,
mySurrogate);
// Other code not shown.
}
Public Shared Sub Constructor8()
' Create a generic List of types and add the known types
' to the collection.
Dim knownTypeList As New List(Of Type)
knownTypeList.Add(GetType(PurchaseOrder))
knownTypeList.Add(GetType(PurchaseOrderV3))
' Create an instance of a class that
' implements the IDataContractSurrogate interface.
' The implementation code is not shown here.
Dim mySurrogate As New DCSurrogate()
Dim ser As New DataContractSerializer(GetType(Person), _
"Customer", _
"http://www.contoso.com", _
knownTypeList, _
64 * 1064, _
True, _
True, _
mySurrogate)
' Other code not shown.
End Sub
Lihat juga
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- KnownTypeAttribute
- IDataContractSurrogate
Berlaku untuk
DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data tak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, dan pengganti untuk serialisasi kustom.
public:
DataContractSerializer(Type ^ type, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate);
public DataContractSerializer (Type type, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate);
new System.Runtime.Serialization.DataContractSerializer : Type * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate)
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- knownTypes
- IEnumerable<Type>
Dari IEnumerable<T> yang Type berisi jenis yang diketahui yang mungkin ada dalam grafik objek.
- maxItemsInObjectGraph
- Int32
Jumlah maksimum item dalam grafik untuk diserialisasikan atau deserialisasi. Defaultnya adalah nilai yang dikembalikan oleh properti Int32.MaxValue .
- ignoreExtensionDataObject
- Boolean
true
untuk mengabaikan data yang disediakan oleh ekstensi jenis setelah serialisasi dan deserialisasi; jika tidak, false
.
- preserveObjectReferences
- Boolean
true
untuk menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek; jika tidak, false
.
- dataContractSurrogate
- IDataContractSurrogate
Implementasi IDataContractSurrogate untuk menyesuaikan proses serialisasi.
Pengecualian
Jumlah item melebihi nilai maksimum.
Contoh
Contoh berikut membuat instans DataContractSerializer yang menentukan jenis untuk membuat serialisasi atau deserialisasi dan instans untuk berisi jenis yang IEnumerable<T> diketahui yang digunakan selama serialisasi atau deserialisasi. Kode ini juga mengatur ignoreExtensionDataObject
parameter dan preserveObjectReferences
ke true
, dan menentukan implementasi IDataContractSurrogate antarmuka untuk menangani jenis warisan (jenis yang tidak memiliki DataContractAttribute atribut yang diterapkan). Untuk informasi selengkapnya, lihat IDataContractSurrogate dokumentasi.
public static void Constructor7()
{
// Create a generic List of types and add the known types
// to the collection.
List<Type> knownTypeList = new List<Type>();
knownTypeList.Add(typeof(PurchaseOrder));
knownTypeList.Add(typeof(PurchaseOrderV3));
// Create an instance of a class that
// implements the IDataContractSurrogate interface.
// The implementation code is not shown here.
DCSurrogate mySurrogate = new DCSurrogate();
DataContractSerializer ser =
new DataContractSerializer(
typeof(Person),
knownTypeList,
64 * 1024,
true,
true,
mySurrogate);
// Other code not shown.
}
Public Shared Sub Constructor7()
' Create a generic List of types and add the known types
' to the collection.
Dim knownTypeList As New List(Of Type)
knownTypeList.Add(GetType(PurchaseOrder))
knownTypeList.Add(GetType(PurchaseOrderV3))
' Create an instance of a class that
' implements the IDataContractSurrogate interface.
' The implementation code is not shown here.
Dim mySurrogate As New DCSurrogate()
Dim ser As New DataContractSerializer(GetType(Person), _
knownTypeList, _
64 * 1064, _
True, _
True, _
mySurrogate)
' Other code not shown.
End Sub
Lihat juga
- MaxItemsInObjectGraph
- PreserveObjectReferences
- IgnoreExtensionDataObject
- IExtensibleDataObject
- ExtensionDataObject
- KnownTypeAttribute
- IDataContractSurrogate
Berlaku untuk
DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan daftar jenis yang diketahui yang mungkin ada dalam grafik objek, jumlah maksimum item grafik untuk diserialisasikan, parameter untuk mengabaikan data tak terduga, apakah akan menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek dalam grafik, pengganti serialisasi kustom, dan alternatif untuk memetakan xsi:type
deklarasi pada waktu proses.
public:
DataContractSerializer(Type ^ type, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System::Runtime::Serialization::IDataContractSurrogate ^ dataContractSurrogate, System::Runtime::Serialization::DataContractResolver ^ dataContractResolver);
public DataContractSerializer (Type type, System.Collections.Generic.IEnumerable<Type> knownTypes, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, bool preserveObjectReferences, System.Runtime.Serialization.IDataContractSurrogate dataContractSurrogate, System.Runtime.Serialization.DataContractResolver dataContractResolver);
new System.Runtime.Serialization.DataContractSerializer : Type * seq<Type> * int * bool * bool * System.Runtime.Serialization.IDataContractSurrogate * System.Runtime.Serialization.DataContractResolver -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, knownTypes As IEnumerable(Of Type), maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, preserveObjectReferences As Boolean, dataContractSurrogate As IDataContractSurrogate, dataContractResolver As DataContractResolver)
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- knownTypes
- IEnumerable<Type>
Dari IEnumerable<T> yang Type berisi jenis yang diketahui yang mungkin ada dalam grafik objek.
- maxItemsInObjectGraph
- Int32
Jumlah maksimum item dalam grafik untuk diserialisasikan atau deserialisasi. Defaultnya adalah nilai yang dikembalikan oleh properti Int32.MaxValue .
- ignoreExtensionDataObject
- Boolean
true
untuk mengabaikan data yang disediakan oleh ekstensi jenis setelah serialisasi dan deserialisasi; jika tidak, false
.
- preserveObjectReferences
- Boolean
true
untuk menggunakan konstruksi XML non-standar untuk mempertahankan data referensi objek; jika tidak, false
.
- dataContractSurrogate
- IDataContractSurrogate
Implementasi IDataContractSurrogate untuk menyesuaikan proses serialisasi.
- dataContractResolver
- DataContractResolver
Implementasi untuk DataContractResolver memetakan xsi:type
deklarasi ke jenis kontrak data.
Keterangan
Peringatan
Metode ini tidak tersedia di aplikasi Bursa Windows.
Berlaku untuk
DataContractSerializer(Type, String, String, IEnumerable<Type>)
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan elemen XML akar dan namespace dalam dua parameter string serta daftar jenis yang diketahui yang mungkin ada dalam grafik objek.
public:
DataContractSerializer(Type ^ type, System::String ^ rootName, System::String ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes);
public DataContractSerializer (Type type, string rootName, string rootNamespace, System.Collections.Generic.IEnumerable<Type> knownTypes);
public DataContractSerializer (Type type, string rootName, string rootNamespace, System.Collections.Generic.IEnumerable<Type>? knownTypes);
new System.Runtime.Serialization.DataContractSerializer : Type * string * string * seq<Type> -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As String, rootNamespace As String, knownTypes As IEnumerable(Of Type))
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- rootName
- String
Nama elemen akar konten.
- rootNamespace
- String
Namespace dari elemen akar.
- knownTypes
- IEnumerable<Type>
Dari IEnumerable<T> yang Type berisi jenis yang mungkin ada dalam grafik objek.
Contoh
Contoh berikut membuat instans DataContractSerializer yang menentukan jenis untuk membuat serialisasi atau deserialisasi serta nama XML dan namespace layanan untuk dibaca dari atau menulis ke dokumen XML. Kode ini juga membuat instans IEnumerable<T> untuk berisi jenis yang diketahui yang digunakan selama serialisasi atau deserialisasi.
public static void Constructor5()
{
// Create a generic List of types and add the known types
// to the collection.
List<Type> knownTypeList = new List<Type>();
knownTypeList.Add(typeof(PurchaseOrder));
knownTypeList.Add(typeof(PurchaseOrderV3));
DataContractSerializer ser =
new DataContractSerializer(
typeof(Person),
"Customer",
@"http://www.contoso.com",
knownTypeList);
// Other code not shown.
}
Public Shared Sub Constructor5()
' Create a generic List of types and add the known types
' to the collection.
Dim knownTypeList As New List(Of Type)
knownTypeList.Add(GetType(PurchaseOrder))
knownTypeList.Add(GetType(PurchaseOrderV3))
Dim ser As New DataContractSerializer(GetType(Person), _
"Customer", _
"http://www.contoso.com", _
knownTypeList)
' Other code not shown.
End Sub
Lihat juga
Berlaku untuk
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
Menginisialisasi instans DataContractSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis yang ditentukan menggunakan elemen akar XML dan namespace yang ditentukan melalui parameter jenis XmlDictionaryString.
public:
DataContractSerializer(Type ^ type, System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace);
public DataContractSerializer (Type type, System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace);
new System.Runtime.Serialization.DataContractSerializer : Type * System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString)
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- rootName
- XmlDictionaryString
Yang XmlDictionaryString berisi nama elemen akar konten.
- rootNamespace
- XmlDictionaryString
Yang XmlDictionaryString berisi namespace elemen akar.
Contoh
Contoh berikut membuat instans DataContractSerializer yang menentukan jenis untuk membuat serialisasi atau deserialisasi serta nama XML dan namespace (sebagai XmlDictionaryString objek) untuk dibaca dari atau menulis ke dokumen XML.
public static void Constructor4()
{
// Create an instance of the DataContractSerializer
// specifying the type, and name and
// namespace as XmlDictionaryString objects.
// 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 the serializer.
DataContractSerializer ser =
new DataContractSerializer(
typeof(Person),
name_value,
ns_value);
// Other code not shown.
}
Public Shared Sub Constructor4()
' Create an instance of the DataContractSerializer
' specifying the type, and name and
' namespace as XmlDictionaryString objects.
' 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 DataContractSerializer(GetType(Person), _
name_value, _
ns_value)
' Other code not shown.
End Sub
Berlaku untuk
DataContractSerializer(Type, String, String)
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan menggunakan elemen akar XML dan namespace yang disediakan.
public:
DataContractSerializer(Type ^ type, System::String ^ rootName, System::String ^ rootNamespace);
public DataContractSerializer (Type type, string rootName, string rootNamespace);
new System.Runtime.Serialization.DataContractSerializer : Type * string * string -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As String, rootNamespace As String)
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- 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 DataContractSerializer yang menentukan jenis untuk membuat serialisasi atau deserialisasi serta nama XML dan namespace layanan untuk dibaca dari atau menulis ke dokumen XML.
public static void Constructor3()
{
// Create an instance of the DataContractSerializer
// specifying the type, and name and
// namespace as strings.
DataContractSerializer ser =
new DataContractSerializer(
typeof(Person),
"Customer",
"http://www.contoso.com");
// Other code not shown.
}
Public Shared Sub Constructor3()
' Create an instance of the DataContractSerializer
' specifying the type, and name and
' namespace as strings.
Dim ser As New DataContractSerializer(GetType(Person), _
"Customer", _
"http://www.contoso.com")
' Other code not shown.
End Sub
Berlaku untuk
DataContractSerializer(Type, DataContractSerializerSettings)
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
Menginisialisasi instans DataContractSerializer baru kelas untuk membuat serialisasi atau deserialisasi objek dari jenis dan pengaturan yang ditentukan.
public:
DataContractSerializer(Type ^ type, System::Runtime::Serialization::DataContractSerializerSettings ^ settings);
public DataContractSerializer (Type type, System.Runtime.Serialization.DataContractSerializerSettings settings);
public DataContractSerializer (Type type, System.Runtime.Serialization.DataContractSerializerSettings? settings);
new System.Runtime.Serialization.DataContractSerializer : Type * System.Runtime.Serialization.DataContractSerializerSettings -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, settings As DataContractSerializerSettings)
Parameter
- type
- Type
Jenis instans yang akan diserialisasikan atau deserialisasi.
- settings
- DataContractSerializerSettings
Pengaturan serializer.
Berlaku untuk
DataContractSerializer(Type, IEnumerable<Type>)
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan, dan kumpulan jenis yang diketahui yang mungkin ada dalam grafik objek.
public:
DataContractSerializer(Type ^ type, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes);
public DataContractSerializer (Type type, System.Collections.Generic.IEnumerable<Type> knownTypes);
public DataContractSerializer (Type type, System.Collections.Generic.IEnumerable<Type>? knownTypes);
new System.Runtime.Serialization.DataContractSerializer : Type * seq<Type> -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, knownTypes As IEnumerable(Of Type))
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- knownTypes
- IEnumerable<Type>
Dari IEnumerable<T> yang Type berisi jenis yang mungkin ada dalam grafik objek.
Contoh
Contoh berikut membuat instans DataContractSerializer yang menentukan jenis untuk membuat serialisasi atau deserialisasi dan kumpulan jenis yang diketahui yang dapat digunakan dalam grafik objek.
public static void Constructor2()
{
// Create a generic List of types and add the known types
// to the collection.
List<Type> knownTypeList = new List<Type>();
knownTypeList.Add(typeof(PurchaseOrder));
knownTypeList.Add(typeof(PurchaseOrderV3));
// Create a DatatContractSerializer with the collection.
DataContractSerializer ser2 = new DataContractSerializer(
typeof(Orders), knownTypeList);
// Other code not shown.
}
Public Shared Sub Constructor2()
' Create a generic List of types and add the known types
' to the collection.
Dim knownTypeList As New List(Of Type)
knownTypeList.Add(GetType(PurchaseOrder))
knownTypeList.Add(GetType(PurchaseOrderV3))
' Create a DatatContractSerializer with the collection.
Dim ser2 As New DataContractSerializer(GetType(Orders), knownTypeList)
' Other code not shown.
End Sub
Lihat juga
Berlaku untuk
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
- Sumber:
- DataContractSerializer.cs
Menginisialisasi instans DataContractSerializer baru kelas untuk menserialisasikan atau mendeserialisasi objek dari jenis yang ditentukan. Metode ini juga menentukan elemen XML akar dan namespace dalam dua XmlDictionaryString parameter serta daftar jenis yang diketahui yang mungkin ada dalam grafik objek.
public:
DataContractSerializer(Type ^ type, System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace, System::Collections::Generic::IEnumerable<Type ^> ^ knownTypes);
public DataContractSerializer (Type type, System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace, System.Collections.Generic.IEnumerable<Type> knownTypes);
public DataContractSerializer (Type type, System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace, System.Collections.Generic.IEnumerable<Type>? knownTypes);
new System.Runtime.Serialization.DataContractSerializer : Type * System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString * seq<Type> -> System.Runtime.Serialization.DataContractSerializer
Public Sub New (type As Type, rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString, knownTypes As IEnumerable(Of Type))
Parameter
- type
- Type
Jenis instans yang diserialisasikan atau dideserialisasi.
- rootName
- XmlDictionaryString
Yang XmlDictionaryString berisi nama elemen akar konten.
- rootNamespace
- XmlDictionaryString
Yang XmlDictionaryString berisi namespace elemen akar.
- knownTypes
- IEnumerable<Type>
IEnumerable<T> Dari Type yang berisi jenis yang diketahui yang mungkin ada dalam grafik objek.
Contoh
Contoh berikut membuat instans DataContractSerializer yang menentukan jenis untuk membuat serialisasi atau deserialisasi serta nama XML dan namespace (sebagai XmlDictionaryString objek) untuk dibaca dari atau menulis ke dokumen XML. Kode ini juga membuat instans IEnumerable<T> untuk berisi jenis yang diketahui yang digunakan selama serialisasi atau deserialisasi.
public static void Constructor6()
{
// Create a generic List of types and add the known types
// to the collection.
List<Type> knownTypeList = new List<Type>();
knownTypeList.Add(typeof(PurchaseOrder));
knownTypeList.Add(typeof(PurchaseOrderV3));
// 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");
DataContractSerializer ser =
new DataContractSerializer(
typeof(Person),
name_value,
ns_value,
knownTypeList);
// Other code not shown.
}
Public Shared Sub Constructor6()
' Create a generic List of types and add the known types
' to the collection.
Dim knownTypeList As New List(Of Type)
knownTypeList.Add(GetType(PurchaseOrder))
knownTypeList.Add(GetType(PurchaseOrderV3))
' 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")
Dim ser As New DataContractSerializer(GetType(Person), _
name_value, _
ns_value, _
knownTypeList)
' Other code not shown.
End Sub