DataContractSerializer Classe

Definizione

Serializza e deserializza un'istanza di un tipo in un flusso o in un documento XML utilizzando un contratto dati fornito. La classe non può essere ereditata.

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
Ereditarietà
DataContractSerializer

Commenti

Per altre informazioni su questa API, vedere Osservazioni supplementari sull'API per DataContractSerializer.

Costruttori

Nome Descrizione
DataContractSerializer(Type, DataContractSerializerSettings)

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo e delle impostazioni specificati.

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

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi del grafo da serializzare, parametri per ignorare i dati imprevisti, se utilizzare costrutti XML non standard per mantenere i dati di riferimento degli oggetti nel grafico, un surrogato per la serializzazione personalizzata e un'alternativa per le dichiarazioni di mapping xsi:type in fase di esecuzione.

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

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi del grafo da serializzare, parametri per ignorare i dati imprevisti, se utilizzare costrutti XML non standard per mantenere i dati di riferimento agli oggetti nel grafico e un surrogato per la serializzazione personalizzata.

DataContractSerializer(Type, IEnumerable<Type>)

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato e una raccolta di tipi noti che possono essere presenti nell'oggetto grafico.

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

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi del grafo da serializzare, parametri per ignorare i dati imprevisti, se utilizzare costrutti XML non standard per mantenere i dati di riferimento agli oggetti nel grafico, un surrogato per la serializzazione personalizzata, l'elemento XML e lo spazio dei nomi che contiene il contenuto, e un'alternativa per le dichiarazioni di mapping xsi:type in fase di esecuzione.

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

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi del grafo da serializzare, parametri per ignorare i dati imprevisti, se utilizzare costrutti XML non standard per mantenere i dati di riferimento agli oggetti nel grafico, un surrogato per la serializzazione personalizzata e l'elemento XML e lo spazio dei nomi che contengono il contenuto.

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

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche l'elemento XML radice e lo spazio dei nomi in due parametri stringa, nonché un elenco di tipi noti che possono essere presenti nell'oggetto grafico.

DataContractSerializer(Type, String, String)

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato utilizzando l'elemento radice e lo spazio dei nomi XML forniti.

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

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi del grafo da serializzare, parametri per ignorare i dati imprevisti, se utilizzare costrutti XML non standard per mantenere i dati di riferimento agli oggetti nel grafico, un surrogato per la serializzazione personalizzata, parametri di XmlDictionaryString che specificano l'elemento XML e lo spazio dei nomi che contiene il contenuto, e un'alternativa per le dichiarazioni di mapping xsi:type in fase di esecuzione.

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

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche un elenco di tipi noti che possono essere presenti nell'oggetto grafico, il numero massimo di elementi del grafico da serializzare, parametri per ignorare i dati imprevisti, se utilizzare costrutti XML non standard per mantenere i dati di riferimento agli oggetti nel grafico, un surrogato per la serializzazione personalizzata e parametri di XmlDictionaryString che specificano l'elemento XML e lo spazio dei nomi che contengono il contenuto.

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

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato. Questo metodo specifica anche l'elemento XML radice e lo spazio dei nomi in due XmlDictionaryString parametri, nonché un elenco di tipi noti che possono essere presenti nell'oggetto grafico.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato utilizzando l'elemento radice XML e lo spazio dei nomi specificati tramite i parametri di tipo XmlDictionaryString.

DataContractSerializer(Type)

Inizializza una nuova istanza della DataContractSerializer classe per serializzare o deserializzare un oggetto del tipo specificato.

Proprietà

Nome Descrizione
DataContractResolver

Ottiene il componente utilizzato per eseguire il mapping xsi:type dinamico delle dichiarazioni ai tipi di contratto noti.

DataContractSurrogate

Ottiene un tipo surrogato che può estendere il processo di serializzazione o deserializzazione.

IgnoreExtensionDataObject

Ottiene un valore che specifica se ignorare i dati forniti da un'estensione della classe quando la classe viene serializzata o deserializzata.

KnownTypes

Ottiene una raccolta di tipi che possono essere presenti nel grafico dell'oggetto serializzato utilizzando questa istanza di DataContractSerializer.

MaxItemsInObjectGraph

Ottiene il numero massimo di elementi in un oggetto grafico da serializzare o deserializzare.

PreserveObjectReferences

Ottiene un valore che specifica se utilizzare costrutti XML non standard per mantenere i dati di riferimento agli oggetti.

SerializeReadOnlyTypes

Ottiene un valore che specifica se i tipi di sola lettura vengono serializzati.

Metodi

Nome Descrizione
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
IsStartObject(XmlDictionaryReader)

Determina se l'oggetto XmlDictionaryReader è posizionato su un oggetto che può essere deserializzato.

IsStartObject(XmlReader)

Determina se l'oggetto XmlReader è posizionato su un oggetto che può essere deserializzato.

MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ReadObject(Stream)

Legge il flusso o il documento XML con un Stream oggetto e restituisce l'oggetto deserializzato.

(Ereditato da XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)

Legge un documento XML o un flusso di documenti e restituisce l'oggetto deserializzato. Il metodo include un parametro per specificare se il nome dell'oggetto viene verificato e un resolver per le dichiarazioni di mapping xsi:type in fase di esecuzione.

ReadObject(XmlDictionaryReader, Boolean)

Legge il flusso XML con un XmlDictionaryReader oggetto e restituisce l'oggetto deserializzato e specifica anche se viene eseguito un controllo per verificare il nome dell'oggetto prima di leggerne il valore.

ReadObject(XmlDictionaryReader)

Legge il documento o il flusso XML con un XmlDictionaryReader oggetto e restituisce l'oggetto deserializzato.

(Ereditato da XmlObjectSerializer)
ReadObject(XmlReader, Boolean)

Legge il flusso XML con un XmlReader oggetto e restituisce l'oggetto deserializzato e specifica anche se viene eseguito un controllo per verificare il nome dell'oggetto prima di leggerne il valore.

ReadObject(XmlReader)

Legge il flusso XML con un oggetto XmlReader e restituisce l'oggetto deserializzato.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
WriteEndObject(XmlDictionaryWriter)

Scrive l'elemento XML di chiusura utilizzando un oggetto XmlDictionaryWriter.

WriteEndObject(XmlWriter)

Scrive l'elemento XML di chiusura utilizzando un oggetto XmlWriter.

WriteObject(Stream, Object)

Scrive il contenuto completo (inizio, contenuto e fine) dell'oggetto nel documento XML o nel flusso con l'oggetto specificato Stream.

(Ereditato da XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object, DataContractResolver)

Scrive tutti i dati dell'oggetto (elemento XML iniziale, contenuto e elemento di inclusione) in un documento o un flusso XML usando l'elemento XmlDictionaryWriter specificato. Il metodo include un sistema di risoluzione per le dichiarazioni di mapping xsi:type in fase di esecuzione.

WriteObject(XmlDictionaryWriter, Object)

Scrive il contenuto completo (inizio, contenuto e fine) dell'oggetto nel documento XML o nel flusso con l'oggetto specificato XmlDictionaryWriter.

(Ereditato da XmlObjectSerializer)
WriteObject(XmlWriter, Object)

Scrive tutti i dati dell'oggetto (elemento XML iniziale, contenuto e elemento di chiusura) in un documento o un flusso XML con un oggetto XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object)

Scrive il contenuto XML utilizzando un oggetto XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object)

Scrive il contenuto XML utilizzando un oggetto XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object)

Scrive l'elemento XML di apertura utilizzando un oggetto XmlDictionaryWriter.

WriteStartObject(XmlWriter, Object)

Scrive l'elemento XML di apertura utilizzando un oggetto XmlWriter.

Metodi di estensione

Nome Descrizione
GetSerializationSurrogateProvider(DataContractSerializer)

Restituisce il provider di serializzazione surrogato per questo serializzatore.

SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider)

Specifica un provider di serializzazione surrogato per questo DataContractSerializeroggetto .

Si applica a

Thread safety

Le istanze di questa classe sono thread-safe tranne quando l'istanza viene usata con un'implementazione di IDataContractSurrogate o DataContractResolver.

Vedi anche