DataContractSerializer Konstruktor

Definisi

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 xsi:type pada durasi.

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.

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 xsi:type deklarasi pada waktu proses.

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

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

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

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

Lihat juga

Berlaku untuk