ISerializable Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Consente a un oggetto di controllare la propria serializzazione e deserializzazione tramite la serializzazione binaria e XML.
public interface class ISerializablepublic interface ISerializable[System.Runtime.InteropServices.ComVisible(true)]
public interface ISerializabletype ISerializable = interface[<System.Runtime.InteropServices.ComVisible(true)>]
type ISerializable = interfacePublic 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. Formatter Crea 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 base di all'interno dell'implementazione GetObjectData 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è .
L'ordine in cui gli oggetti vengono deserializzati non può essere garantito. Ad esempio, se un tipo fa riferimento a un tipo che non è ancora stato 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 SerializableAttribute e implementare l'interfaccia ISerializable come qualsiasi altro tipo di oggetto. Lo stato dell'oggetto verrà acquisito e salvato in modo permanente 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 per .MarshalByRefObject Un surrogato è un helper che sa come serializzare e deserializzare oggetti di un particolare tipo. 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 estendi 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 oggetto MemoryStream. 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 la comunicazione remota, un oggetto di questo tipo verrebbe inoltrato tramite proxy.
Per altre informazioni sulla serializzazione di classi che estendono MarshalByRefObject, vedere RemotingSurrogateSelector. Per altre informazioni sull'implementazione ISerializabledi , vedere Serializzazione personalizzata.
Note
Questa interfaccia non si applica alla serializzazione JSON tramite System.Text.Json.
Note per gli implementatori
Implementare questa interfaccia per consentire a un oggetto di partecipare alla propria serializzazione e deserializzazione.
Metodi
| Nome | Descrizione |
|---|---|
| GetObjectData(SerializationInfo, StreamingContext) |
Popola un SerializationInfo oggetto con i dati necessari per serializzare l'oggetto di destinazione. |