DataContractSerializer Klasa

Definicja

Przestrzeń nazw:

System.Runtime.Serialization

Zestawy:

netstandard.dll, 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

Nazwa	Opis
DataContractSerializer(Type, DataContractSerializerSettings)	Inicjuje nowe wystąpienie DataContractSerializer 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, IEnumerable<Type>)	Inicjuje nowe wystąpienie DataContractSerializer klasy, aby serializować lub deserializować obiekt 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, String, String)	Inicjuje nowe wystąpienie DataContractSerializer klasy, aby serializować lub deserializować obiekt określonego typu przy użyciu podanego elementu głównego XML i przestrzeni nazw.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)	Inicjuje nowe wystąpienie DataContractSerializer klasy, aby serializować lub deserializować obiekt 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 obiektów.
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)	Inicjuje nowe wystąpienie DataContractSerializer klasy, aby serializować lub deserializować obiekt określonego typu.

Właściwości

Nazwa	Opis
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 lub deserializowana.
KnownTypes	Pobiera kolekcję typów, które mogą być obecne na grafie obiektu serializowane przy użyciu tego wystąpienia DataContractSerializerklasy .
MaxItemsInObjectGraph	Pobiera maksymalną liczbę elementów na grafie obiektu w celu serializacji lub deserializacji.
PreserveObjectReferences	Pobiera wartość określającą, czy używać niestandardowych konstrukcji XML do zachowywania danych referencyjnych obiektów.
SerializeReadOnlyTypes	Pobiera wartość określającą, czy typy tylko do odczytu są serializowane.

Metody

Nazwa	Opis
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
IsStartObject(XmlDictionaryReader)	Określa, czy XmlDictionaryReader obiekt jest umieszczony na obiekcie, który może zostać zdeserializowany.
IsStartObject(XmlReader)	Określa, czy XmlReader obiekt jest umieszczony na obiekcie, który może zostać zdeserializowany.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ReadObject(Stream)	Odczytuje strumień XML lub dokument za pomocą obiektu Stream i zwraca zdeserializowany obiekt. (Odziedziczone po XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)	Odczytuje dokument XML lub strumień dokumentu i zwraca zdeserializowany obiekt. Metoda zawiera parametr określający, czy nazwa obiektu jest weryfikowana, oraz program rozpoznawania deklaracji mapowania xsi:type w czasie wykonywania.
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)	Odczytuje dokument XML lub strumień za pomocą elementu XmlDictionaryReader i zwraca zdeserializowany obiekt. (Odziedziczone po XmlObjectSerializer)
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.
ReadObject(XmlReader)	Odczytuje strumień XML za pomocą elementu XmlReader i zwraca zdeserializowany obiekt.
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 do dokumentu XML lub strumienia o określonym obiekcie Stream. (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 narzędzie rozpoznawania deklaracji mapowania xsi:type w czasie wykonywania.
WriteObject(XmlDictionaryWriter, Object)	Zapisuje pełną zawartość (początek, zawartość i koniec) obiektu do dokumentu XML lub strumienia o określonym obiekcie XmlDictionaryWriter. (Odziedziczone po XmlObjectSerializer)
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

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

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
• Korzystanie z kontraktów danych
• Serializacja i deserializacja