ISerializable Interfaccia

Definizione

Consente a un oggetto di controllare la propria serializzazione e deserializzazione tramite serializzazione binaria e XML.

public interface class ISerializable
public interface ISerializable
[System.Runtime.InteropServices.ComVisible(true)]
public interface ISerializable
type ISerializable = interface
[<System.Runtime.InteropServices.ComVisible(true)>]
type ISerializable = interface
Public Interface ISerializable
Derivato
Attributi

Commenti

Qualsiasi classe che potrebbe essere serializzata utilizzando la serializzazione binaria o XML deve essere contrassegnata con .SerializableAttribute Se una classe deve controllare il processo di serializzazione binario o XML, può implementare l'interfaccia ISerializable . Chiama Formatter l'oggetto GetObjectData in fase di serializzazione e popola l'oggetto fornito SerializationInfo con tutti i dati necessari per rappresentare l'oggetto. Crea Formatter un SerializationInfo oggetto con il tipo dell'oggetto nel grafico. Gli oggetti che devono inviare proxy per se stessi possono usare i FullTypeName metodi e AssemblyName su SerializationInfo per modificare le informazioni trasmesse.

Nel caso dell'ereditarietà della classe, è possibile serializzare una classe che deriva da una classe di base che implementa ISerializable. In questo caso, la classe derivata deve chiamare l'implementazione della classe di base di GetObjectData all'interno dell'implementazione di GetObjectData. In caso contrario, i dati della classe di base non verranno serializzati.

L'interfaccia ISerializable implica un costruttore con la firma constructor (SerializationInfo information, StreamingContext context). In fase di deserializzazione, il costruttore corrente viene chiamato solo dopo che i dati in sono SerializationInfo stati deserializzati dal formattatore. In generale, questo costruttore deve essere protected se la classe non sealedè .

Non è possibile garantire l'ordine in cui gli oggetti sono deserializzati. Ad esempio, se un tipo fa riferimento a un tipo che non è stato ancora deserializzato, si verificherà un'eccezione. Se si creano tipi con tali dipendenze, è possibile risolvere il problema implementando l'interfaccia IDeserializationCallback e il OnDeserialization metodo.

L'architettura di serializzazione gestisce i tipi di oggetto che estendono gli stessi tipi che estendono MarshalByRefObjectObject. Questi tipi possono essere contrassegnati con l'oggetto e implementano l'interfaccia SerializableAttributeISerializable come qualsiasi altro tipo di oggetto. Lo stato dell'oggetto verrà acquisito e mantenuto nel flusso.

Quando questi tipi vengono usati tramite System.Runtime.Remoting, l'infrastruttura di comunicazione remota fornisce un surrogato che impedisce la serializzazione tipica e serializza invece un proxy all'oggetto MarshalByRefObject. Un surrogato è un helper che sa come serializzare e deserializzare gli oggetti di un tipo specifico. Il proxy, invisibile all'utente nella maggior parte dei casi, sarà di tipo ObjRef.

Come modello di progettazione generale, sarebbe insolito che una classe sia contrassegnata con l'attributo serializzabile ed estende MarshalByRefObject. Gli sviluppatori devono considerare attentamente i possibili scenari di serializzazione e comunicazione remota quando si combinano queste due caratteristiche. Un esempio in cui può essere applicabile è con un MemoryStreamoggetto . Mentre la classe di base di MemoryStream (Stream) si estende da MarshalByRefObject, è possibile acquisire lo stato di un MemoryStream oggetto e ripristinarlo a volontà. Potrebbe quindi essere significativo serializzare lo stato di questo flusso in un database e ripristinarlo in un secondo momento. Tuttavia, quando viene usato tramite comunicazione remota, un oggetto di questo tipo sarà proxied.

Per altre informazioni sulla serializzazione delle classi che estendono MarshalByRefObject, vedere RemotingSurrogateSelector. Per altre informazioni sull'implementazione ISerializabledi , vedere Serializzazione personalizzata.

Nota

Questa interfaccia non si applica alla serializzazione JSON usando System.Text.Json.

Note per gli implementatori

Implementare questa interfaccia per consentire a un oggetto di partecipare alla propria serializzazione e deserializzazione.

Metodi

GetObjectData(SerializationInfo, StreamingContext)
Obsoleti.

Popola un oggetto SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione.

Si applica a

Vedi anche