DataContractSerializer Klasa

Definicja

Przestrzeń nazw:

System.Runtime.Serialization

Zestaw:

System.Runtime.Serialization.Xml.dll

Źródło:

DataContractSerializer.cs

Serializuje i deserializuje wystąpienie typu do strumienia XML lub dokumentu przy użyciu dostarczonego kontraktu danych. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

XmlObjectSerializer

DataContractSerializer

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla elementu DataContractSerializer.

Konstruktory

DataContractSerializer(Type)	Inicjuje DataContractSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu.
DataContractSerializer(Type, DataContractSerializerSettings)	Inicjuje DataContractSerializer nowe wystąpienie klasy, aby serializować lub deserializować obiekt określonego typu i ustawień.
DataContractSerializer(Type, IEnumerable<Type>)	Inicjuje nowe wystąpienie DataContractSerializer klasy w celu serializacji lub deserializacji obiektu określonego typu oraz kolekcji znanych typów, które mogą znajdować się na grafie obiektu.
DataContractSerializer(Type, String, String)	Inicjuje DataContractSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu przy użyciu podanego elementu głównego XML i przestrzeni nazw.
DataContractSerializer(Type, String, String, IEnumerable<Type>)	Inicjuje DataContractSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również główny element XML i przestrzeń nazw w dwóch parametrach ciągu, a także listę znanych typów, które mogą być obecne na grafie obiektu.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)	Inicjuje nowe wystąpienie DataContractSerializer klasy w celu serializacji lub deserializacji obiektu określonego typu przy użyciu elementu głównego XML i przestrzeni nazw określonej za pomocą parametrów typu XmlDictionaryString.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)	Inicjuje DataContractSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również główny element XML i przestrzeń nazw w dwóch XmlDictionaryString parametrach, a także listę znanych typów, które mogą być obecne na grafie obiektu.

Właściwości

DataContractResolver	Pobiera składnik używany do dynamicznego mapowania xsi:type deklaracji na znane typy kontraktów.
IgnoreExtensionDataObject	Pobiera wartość określającą, czy ignorować dane dostarczane przez rozszerzenie klasy, gdy klasa jest serializowana, czy deserializowana.
KnownTypes	Pobiera kolekcję typów, które mogą być obecne w grafie obiektu serializacji przy użyciu tego wystąpienia klasy DataContractSerializer.
MaxItemsInObjectGraph	Pobiera maksymalną liczbę elementów na grafie obiektu w celu serializacji lub deserializacji.
PreserveObjectReferences	Pobiera wartość określającą, czy należy używać niestandardowych konstrukcji XML do zachowywania danych odwołania do obiektów.
SerializeReadOnlyTypes	Pobiera wartość określającą, czy typy tylko do odczytu są serializowane.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsStartObject(XmlDictionaryReader)	Określa, czy XmlDictionaryReader obiekt jest umieszczony na obiekcie, który można deserializować.
IsStartObject(XmlReader)	Określa, czy XmlReader obiekt jest umieszczony na obiekcie, który można deserializować.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ReadObject(Stream)	Odczytuje strumień XML lub dokument z obiektem Stream i zwraca zdeserializowany obiekt. (Odziedziczone po XmlObjectSerializer)
ReadObject(XmlDictionaryReader)	Odczytuje dokument XML lub strumień za pomocą obiektu XmlDictionaryReader i zwraca obiekt deserializowany. (Odziedziczone po XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean)	Odczytuje strumień XML z obiektem XmlDictionaryReader i zwraca obiekt deserializowany, a także określa, czy sprawdzanie jest wykonywane w celu zweryfikowania nazwy obiektu przed odczytaniem jego wartości.
ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)	Odczytuje dokument XML lub strumień dokumentu i zwraca obiekt deserializowany. Metoda zawiera parametr określający, czy nazwa obiektu jest weryfikowana, oraz program rozpoznawania deklaracji mapowania xsi:type w czasie wykonywania.
ReadObject(XmlReader)	Odczytuje strumień XML z obiektem XmlReader i zwraca obiekt deserializowany.
ReadObject(XmlReader, Boolean)	Odczytuje strumień XML z obiektem XmlReader i zwraca obiekt deserializowany, a także określa, czy sprawdzanie jest wykonywane w celu zweryfikowania nazwy obiektu przed odczytaniem jego wartości.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
WriteEndObject(XmlDictionaryWriter)	Zapisuje zamykający element XML przy użyciu elementu XmlDictionaryWriter.
WriteEndObject(XmlWriter)	Zapisuje zamykający element XML przy użyciu elementu XmlWriter.
WriteObject(Stream, Object)	Zapisuje pełną zawartość (początek, zawartość i koniec) obiektu w dokumencie XML lub strumieniu przy użyciu określonego Streamelementu . (Odziedziczone po XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object)	Zapisuje pełną zawartość (początek, zawartość i koniec) obiektu w dokumencie XML lub strumieniu przy użyciu określonego XmlDictionaryWriterelementu . (Odziedziczone po XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object, DataContractResolver)	Zapisuje wszystkie dane obiektu (początkowy element XML, zawartość i element otaczający) do dokumentu XML lub strumienia przy użyciu określonego elementu XmlDictionaryWriter. Metoda zawiera program rozpoznawania nazw dla deklaracji mapowania xsi:type w czasie wykonywania.
WriteObject(XmlWriter, Object)	Zapisuje wszystkie dane obiektu (początkowy element XML, zawartość i element zamykający) do dokumentu XML lub strumienia za pomocą elementu XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)	Zapisuje zawartość XML przy użyciu elementu XmlDictionaryWriter.
WriteObjectContent(XmlWriter, Object)	Zapisuje zawartość XML przy użyciu elementu XmlWriter.
WriteStartObject(XmlDictionaryWriter, Object)	Zapisuje otwierający element XML przy użyciu elementu XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)	Zapisuje otwierający element XML przy użyciu elementu XmlWriter.

Metody rozszerzania

GetSerializationSurrogateProvider(DataContractSerializer)	Zwraca dostawcę serializacji zastępczej dla tego serializatora.
SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider)	Określa dostawcę serializacji zastępczej dla tego DataContractSerializerelementu .

Bezpieczeństwo wątkowe

Wystąpienia tej klasy są bezpieczne wątkami, z wyjątkiem sytuacji, gdy wystąpienie jest używane z implementacją klasy IDataContractSurrogate lub DataContractResolver.

Zobacz też

• DataMemberAttribute
• DataContractAttribute
• IExtensibleDataObject
• ExtensionDataObject
• Używanie kontraktów danych
• Serializacja i deserializacja