DataContractSerializer Sınıf

Tanım

Sağlanan veri sözleşmesini kullanarak bir türün örneğini seri hale getirerek seri durumdan çıkararak XML akışına veya belgesine ekler. Bu sınıf devralınamaz.

public ref class DataContractSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer
public sealed class DataContractSerializer : System.Runtime.Serialization.XmlObjectSerializer
type DataContractSerializer = class
    inherit XmlObjectSerializer
Public NotInheritable Class DataContractSerializer
Inherits XmlObjectSerializer
Devralma
DataContractSerializer

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz. DataContractSerializer için ek API açıklamaları.

Oluşturucular

DataContractSerializer(Type)

Belirtilen türdeki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır.

DataContractSerializer(Type, DataContractSerializerSettings)

Belirtilen tür ve ayarlardaki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır.

DataContractSerializer(Type, IEnumerable<Type>)

Belirtilen türdeki DataContractSerializer bir nesneyi serileştirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini ve nesne grafında mevcut olabilecek bilinen türlerden oluşan bir koleksiyonu başlatır.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Belirtilen türdeki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır. Bu yöntem ayrıca nesne grafında bulunabilecek bilinen türlerin listesini, seri hale getirilecek grafik öğelerinin üst sınırını, beklenmeyen verileri yoksayacak parametreleri, grafikteki nesne başvuru verilerini korumak için standart olmayan XML yapılarının kullanılıp kullanılmayacağını ve özel serileştirme için bir vekil belirtir.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Belirtilen türdeki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır. Bu yöntem ayrıca, nesne grafında bulunabilecek bilinen türlerin listesini, serileştirilecek grafik öğelerinin üst sınırını, beklenmeyen verileri yoksayacak parametreleri, grafikteki nesne başvuru verilerini korumak için standart olmayan XML yapılarının kullanılıp kullanılmayacağını, özel serileştirme için bir vekili ve çalışma zamanında eşleme xsi:type bildirimleri için alternatifi belirtir.

DataContractSerializer(Type, String, String)

Sağlanan XML kök öğesini ve ad alanını kullanarak belirtilen türdeki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır.

DataContractSerializer(Type, String, String, IEnumerable<Type>)

Belirtilen türdeki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır. Bu yöntem ayrıca iki dize parametresinde kök XML öğesini ve ad alanını ve nesne grafında mevcut olabilecek bilinen türlerin listesini belirtir.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Belirtilen türdeki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır. Bu yöntem ayrıca nesne grafında bulunabilecek bilinen türlerin listesini, serileştirilecek grafik öğelerinin üst sınırını, beklenmeyen verileri yoksayacak parametreleri, grafikteki nesne başvuru verilerini korumak için standart olmayan XML yapılarının kullanılıp kullanılmayacağını, özel serileştirme için bir vekili ve içeriği içeren XML öğesini ve ad alanını belirtir.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Belirtilen türdeki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır. Bu yöntem ayrıca nesne grafında bulunabilecek bilinen türlerin listesini, seri hale getirilecek en fazla grafik öğesi sayısını, beklenmeyen verileri yoksayacak parametreleri, grafikteki nesne başvuru verilerini korumak için standart olmayan XML yapılarının kullanılıp kullanılmayacağını, özel serileştirmeye yönelik bir vekili, içeriği içeren XML öğesini ve ad alanını belirtir. ve çalışma zamanında bildirimleri eşlemek xsi:type için bir alternatif.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

türündeki DataContractSerializer parametreler aracılığıyla belirtilen XML kök öğesini ve ad alanını kullanarak belirtilen türdeki bir nesneyi serileştirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini XmlDictionaryStringbaşlatır.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)

Belirtilen türdeki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır. Bu yöntem ayrıca iki XmlDictionaryString parametrede kök XML öğesini ve ad alanını ve nesne grafında mevcut olabilecek bilinen türlerin listesini belirtir.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Belirtilen türdeki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır. Bu yöntem ayrıca nesne grafında bulunabilecek bilinen türlerin listesini, serileştirilecek grafik öğelerinin üst sınırını, beklenmeyen verileri yoksayacak parametreleri, grafikteki nesne başvuru verilerini korumak için standart olmayan XML yapılarının kullanılıp kullanılmayacağını, özel serileştirme için bir vekili ve içeriği içeren XML öğesini ve ad alanını belirten parametrelerini XmlDictionaryString belirtir.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

Belirtilen türdeki DataContractSerializer bir nesneyi seri hale getirmek veya seri durumdan çıkarabilmek için sınıfının yeni bir örneğini başlatır. Bu yöntem ayrıca nesne grafında bulunabilecek bilinen türlerin listesini, serileştirilecek grafik öğelerinin üst sınırını, beklenmeyen verileri yoksayacak parametreleri, grafikteki nesne başvuru verilerini korumak için standart olmayan XML yapılarının kullanılıp kullanılmayacağını, özel serileştirmeye yönelik bir vekili, içeriği içeren XML öğesini ve ad alanını belirten parametrelerini XmlDictionaryString belirtir, ve çalışma zamanında bildirimleri eşlemek xsi:type için bir alternatif.

Özellikler

DataContractResolver

Bildirimleri bilinen sözleşme türleriyle dinamik olarak eşlemek xsi:type için kullanılan bileşeni alır.

DataContractSurrogate

Serileştirme veya seri durumdan çıkarma işlemini genişletebilen bir vekil tür alır.

IgnoreExtensionDataObject

Sınıf serileştirilirken veya seri durumdan çıkarılırken sınıfın bir uzantısı tarafından sağlanan verilerin yoksayılıp yoksayılmayacağını belirten bir değer alır.

KnownTypes

Nesne grafında bulunabilecek türlerin koleksiyonunu, bu örneğini kullanarak seri hale getirerek DataContractSerializeralır.

MaxItemsInObjectGraph

Seri hale getirmek veya seri durumdan çıkarabilmek için nesne grafiğindeki en fazla öğe sayısını alır.

PreserveObjectReferences

Nesne başvuru verilerini korumak için standart olmayan XML yapılarının kullanılıp kullanılmayacağını belirten bir değer alır.

SerializeReadOnlyTypes

Salt okunur türlerin seri hale getirilip getirilmeyeceğini belirten bir değer alır.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
IsStartObject(XmlDictionaryReader)

öğesinin XmlDictionaryReader seri durumdan çıkarılabilir bir nesneye yerleştirilip yerleştirilmeyeceğini belirler.

IsStartObject(XmlReader)

öğesinin XmlReader seri durumdan çıkarılabilir bir nesneye yerleştirilip yerleştirilmeyeceğini belirler.

MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ReadObject(Stream)

XML akışını veya belgesini ile Stream okur ve seri durumdan çıkarılmış nesneyi döndürür.

(Devralındığı yer: XmlObjectSerializer)
ReadObject(XmlDictionaryReader)

XML belgesini veya akışını bir XmlDictionaryReader ile okur ve seri durumdan çıkarılmış nesneyi döndürür.

(Devralındığı yer: XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean)

XML akışını ile XmlDictionaryReader okur ve seri durumdan çıkarılmış nesneyi döndürür ve ayrıca değerini okumadan önce nesne adını doğrulamak için bir denetim yapılıp yapılmayacağını belirtir.

ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)

XML belgesini veya belge akışını okur ve seri durumdan çıkarılmış nesneyi döndürür. yöntemi, nesne adının doğrulanıp doğrulanmayacağını belirten bir parametre ve çalışma zamanında bildirimleri eşlemek xsi:type için bir çözümleyici içerir.

ReadObject(XmlReader)

XML akışını ile XmlReader okur ve seri durumdan çıkarılmış nesneyi döndürür.

ReadObject(XmlReader, Boolean)

XML akışını ile XmlReader okur ve seri durumdan çıkarılmış nesneyi döndürür ve ayrıca değerini okumadan önce nesne adını doğrulamak için bir denetim yapılıp yapılmayacağını belirtir.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
WriteEndObject(XmlDictionaryWriter)

kapanış XML öğesini kullanarak XmlDictionaryWriteryazar.

WriteEndObject(XmlWriter)

kapanış XML öğesini kullanarak XmlWriteryazar.

WriteObject(Stream, Object)

Nesnenin tam içeriğini (başlangıç, içerik ve bitiş) belirtilen Streamile XML belgesine veya akışına yazar.

(Devralındığı yer: XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object)

Nesnenin tam içeriğini (başlangıç, içerik ve bitiş) belirtilen XmlDictionaryWriterile XML belgesine veya akışına yazar.

(Devralındığı yer: XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object, DataContractResolver)

Belirtilen XmlDictionaryWriter kullanarak tüm nesne verilerini (başlangıç XML öğesi, içerik ve kapsayan öğe) bir XML belgesine veya akışına yazar. yöntemi, çalışma zamanında bildirimleri eşlemek xsi:type için bir çözümleyici içerir.

WriteObject(XmlWriter, Object)

Tüm nesne verilerini (başlangıç XML öğesi, içerik ve kapanış öğesi) bir XML belgesine veya akışına ile yazar XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object)

KULLANARAK XmlDictionaryWriterXML içeriğini yazar.

WriteObjectContent(XmlWriter, Object)

KULLANARAK XmlWriterXML içeriğini yazar.

WriteStartObject(XmlDictionaryWriter, Object)

açılış XML öğesini kullanarak XmlDictionaryWriteryazar.

WriteStartObject(XmlWriter, Object)

açılış XML öğesini kullanarak XmlWriteryazar.

Uzantı Metotları

GetSerializationSurrogateProvider(DataContractSerializer)

Bu seri hale getirici için vekil serileştirme sağlayıcısını döndürür.

SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider)

Bu DataContractSerializeriçin bir vekil serileştirme sağlayıcısı belirtir.

Şunlara uygulanır

İş Parçacığı Güvenliği

Bu sınıfın örnekleri, örneğin veya DataContractResolveruygulamasıyla kullanılması dışında iş parçacığı güvenlidirIDataContractSurrogate.

Ayrıca bkz.