Udostępnij za pośrednictwem


DataContractSerializer Klasa

Definicja

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
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, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Inicjuje DataContractSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również listę znanych typów, które mogą być obecne na grafie obiektów, maksymalną liczbę elementów grafu do serializacji, parametry ignorowania nieoczekiwanych danych, czy używać niestandardowych konstrukcji XML do zachowania danych odwołania do obiektów w grafie i zastępcy niestandardowej serializacji.

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

Inicjuje DataContractSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również listę znanych typów, które mogą być obecne na grafie obiektów, maksymalną liczbę elementów grafu do serializacji, parametry ignorowania nieoczekiwanych danych, czy używać niestandardowych konstrukcji XML do zachowania danych odwołania do obiektów w grafie, zastępczej dla niestandardowej serializacji i alternatywy dla deklaracji mapowania xsi:type w czasie wykonywania.

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, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

Inicjuje DataContractSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również listę znanych typów, które mogą być obecne na grafie obiektów, maksymalną liczbę elementów grafu do serializacji, parametry ignorowania nieoczekiwanych danych, czy używać niestandardowych konstrukcji XML do zachowania danych odwołania do obiektu w grafie, zastępcy niestandardowej serializacji oraz elementu XML i przestrzeni nazw zawierającej zawartość.

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

Inicjuje DataContractSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również listę znanych typów, które mogą być obecne na grafie obiektów, maksymalną liczbę elementów grafu do serializacji, parametry ignorowania nieoczekiwanych danych, czy używać niestandardowych konstrukcji XML do zachowania danych odwołania do obiektu w grafie, zastępcy niestandardowej serializacji, elementu XML i przestrzeni nazw zawierającej zawartość, i alternatywa dla deklaracji mapowania xsi:type w czasie wykonywania.

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.

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

Inicjuje DataContractSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również listę znanych typów, które mogą być obecne na grafie obiektów, maksymalną liczbę elementów grafu do serializacji, parametry ignorować nieoczekiwane dane, czy używać niestandardowych konstrukcji XML do zachowania danych odwołania do obiektu w grafie, zastępczej dla niestandardowej serializacji i parametrów XmlDictionaryString , które określają element XML i przestrzeń nazw, które zawierają zawartość.

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

Inicjuje DataContractSerializer nowe wystąpienie klasy w celu serializacji lub deserializacji obiektu określonego typu. Ta metoda określa również listę znanych typów, które mogą być obecne na grafie obiektów, maksymalną liczbę elementów grafu do serializacji, parametry ignorowania nieoczekiwanych danych, czy używać niestandardowych konstrukcji XML w celu zachowania danych odwołania do obiektu w grafie, zastępczych dla niestandardowej serializacji, parametrów XmlDictionaryString , które określają element XML i przestrzeń nazw, która zawiera zawartość, i alternatywa dla deklaracji mapowania xsi:type w czasie wykonywania.

Właściwości

DataContractResolver

Pobiera składnik używany do dynamicznego mapowania xsi:type deklaracji na znane typy kontraktów.

DataContractSurrogate

Pobiera typ zastępczy, który może rozszerzyć proces serializacji lub deserializacji.

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 .

Dotyczy

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ż