Serializzazione

La serializzazione è il processo di conversione di un oggetto in un formato che può essere facilmente persistente o trasportato. Ad esempio, è possibile serializzare un oggetto, trasferirlo su Internet tramite HTTP e deserializzarlo nel computer di destinazione.

In .NET Framework sono disponibili tre tecnologie di serializzazione principali ottimizzate per vari scenari di serializzazione. Nella tabella seguente vengono elencate tali tecnologie e vengono indicati i principali tipi .NET Framework correlati.

✔️ PRENDERE IN CONSIDERAZIONE la serializzazione quando si progettano nuovi tipi.

Scelta della tecnologia di serializzazione corretta da supportare

✔️ CONSIDERARE il supporto della serializzazione del contratto dati se le istanze del tipo potrebbero dover essere rese persistenti o usate nei servizi Web.

✔️ Considerare il supporto della serializzazione XML al posto di o in aggiunta alla serializzazione del contratto dati se è necessario disporre di maggiore controllo sul formato XML creato quando il tipo viene serializzato.

Questo aspetto può essere necessario in alcuni scenari di interoperabilità in cui è necessario utilizzare un costrutto XML non supportato dalla serializzazione dei contratti dati, ad esempio per creare attributi XML.

✔️ CONSIDERARE il supporto della serializzazione di runtime se le istanze del tipo devono attraversare i limiti di comunicazione remota .NET.

❌ EVITARE di supportare la serializzazione di runtime o la serializzazione XML solo per motivi di persistenza generali. Dare invece la preferenza alla serializzazione dei contratti dati.

Supporto della serializzazione dei contratti dati

Affinché i tipi supportino la serializzazione dei contratti dati, è necessario applicare DataContractAttribute al tipo e DataMemberAttribute ai membri (campi e proprietà) del tipo.

✔️ VALUTARE la possibilità di contrassegnare i membri dati del tipo pubblico se il tipo può essere usato in attendibilità parziale.

In condizioni di attendibilità totale, i serializzatori dei contratti dati possono serializzare e deserializzare anche tipi e membri non pubblici, mentre in condizioni di attendibilità parziale possono essere serializzati o deserializzati solo i membri pubblici.

✔️ IMPLEMENTARE un getter e un setter in tutte le proprietà con DataMemberAttribute. Affinché il tipo possa essere considerato serializzabile, i serializzatori dei contratti dati richiedono entrambi i metodi. In .NET Framework 3.5 SP1 alcune proprietà della raccolta possono essere di sola lettura. Se il tipo non verrà utilizzato in condizioni di attendibilità parziale, è possibile che una o entrambe le funzioni di accesso alle proprietà non siano pubbliche.

✔️ Utilizzare i callback di serializzazione per l'inizializzazione di istanze deserializzate.

Poiché i costruttori non vengono chiamati quando gli oggetti sono deserializzati, Esistono due eccezioni alla regola. I costruttori di raccolte contrassegnati con CollectionDataContractAttribute vengono chiamati durante la deserializzazione. Pertanto, qualsiasi logica eseguita durante la costruzione normale deve essere implementata come uno dei callback di serializzazione.

OnDeserializedAttribute è l'attributo di callback più comunemente utilizzato. Gli altri attributi della famiglia sono OnDeserializingAttribute, OnSerializingAttribute e OnSerializedAttribute. Tali attributi possono essere utilizzati rispettivamente per contrassegnare callback eseguiti prima della deserializzazione, prima della serializzazione e dopo la serializzazione.

✔️ CONSIDERARE l'utilizzo di KnownTypeAttribute per indicare tipi concreti da utilizzare in caso di deserializzazione di un oggetto grafico complesso.

✔️ CONSIDERARE la compatibilità con le versioni precedenti e successive quando si creano o si modificano tipi serializzabili.

Tenere presente che i flussi serializzati di versioni future del tipo possono essere deserializzati nella versione corrente del tipo e viceversa.

È importante comprendere che nelle versioni future del tipo non è possibile modificare il nome, il tipo o l'ordine dei membri dati, anche privati e interni, a meno che non si presti particolare attenzione a mantenere il contratto utilizzando parametri espliciti per gli attributi del contratto dati.

Testare la compatibilità della serializzazione quando si apportano modifiche ai tipi serializzabili. provando ad esempio a deserializzare la nuova versione in una versione precedente e viceversa.

✔️ CONSIDERARE l'implementazione dI IExtensibleDataObject per consentire le sequenze di andata e ritorno tra versioni diverse del tipo.

L'interfaccia consente al serializzatore di verificare che durante le sequenze di andata e ritorno non venga perso alcun dato. La proprietà IExtensibleDataObject.ExtensionData viene utilizzata per archiviare tutti i dati della versione futura del tipo sconosciuto alla versione corrente, e quindi non può archiviarlo nei relativi membri dati. Successivamente, quando la versione corrente viene serializzata e deserializzata in una versione futura, i dati aggiuntivi saranno disponibili nel flusso serializzato.

Supporto della serializzazione XML

La serializzazione dei contratti dati è la tecnologia di serializzazione principale e predefinita in .NET Framework, anche se non supporta tutti gli scenari di serializzazione. ad esempio non consente di controllare completamente la forma del codice XML creato o utilizzato dal serializzatore. Se è richiesto un controllo così dettagliato, è necessario usare la serializzazione XML nonché progettare i tipi in modo che supportino questa tecnologia di serializzazione.

❌ EVITARE di progettare in maniera specifica i tipi per la serializzazione XML, a meno che non sia presente un motivo estremamente valido per controllare la forma del codice XML creato. Questa tecnologia è stata sostituita dalla serializzazione dei contratti dati descritta nella sezione precedente.

✔️ CONSIDERARE l'implementazione dell'interfacciaIXmlSerializable se si desidera maggiore controllo sulla forma del codice XML serializzato rispetto a quello offerto applicando gli attributi della serializzazione XML. Per controllare completamente il flusso XML serializzato, è possibile utilizzare due metodi dell'interfaccia, ovvero ReadXml e WriteXml. È inoltre possibile controllare l'XML Schema generato per il tipo applicando XmlSchemaProviderAttribute.

Supporto della serializzazione di runtime

La serializzazione di runtime è una tecnologia usata dai servizi remoti .NET. Se si ritiene che i tipi verranno trasportati utilizzando i servizi remoti .NET, è necessario verificare che supportino la serializzazione di runtime.

Il supporto di base per la serializzazione di runtim può essere fornito applicando SerializableAttribute, e scenari più avanzati prevedono l'implementazione di un semplice modello di runtime serializzabile (implementazione di ISerializable e specifica di un costruttore di serializzazione).

✔️ CONSIDERARE il supporto della serializzazione di runtime se i tipi verranno utilizzati con i servizi remoti .NET. Lo spazio dei nomi System.AddIn, ad esempio, utilizza i servizi remoti .NET e pertanto tutti i tipi scambiati tra i componenti aggiuntivi System.AddIn devono supportare la serializzazione di runtime.

✔️ Considerare l'implementazione del modello di runtime serializzabile se si vuole il controllo completo sul processo di serializzazione. ad esempio se si desidera trasformare i dati quando vengono serializzati o deserializzati.

Il modello è molto semplice. È sufficiente implementare l'interfaccia ISerializable e specificare un costruttore speciale utilizzato quando l'oggetto viene deserializzato.

✔️ Creare il costruttore di serializzazione in modo protetto e specificare due parametri digitati e denominati esattamente come indicato nell'esempio.

[Serializable]
public class Person : ISerializable
{
    protected Person(SerializationInfo info, StreamingContext context)
    {
        // ...
    }
}

✔️ IMPLEMENTARE i membri ISerializable in modo esplicito.

✔️ APPLICARE una richiesta di collegamento all'implementazione ISerializable.GetObjectData. In questo modo si garantisce che solo il core completamente attendibile e il serializzatore di runtime abbiano accesso al membro.

Parti protette da copyright © 2005, 2009 Microsoft Corporation. Tutti i diritti sono riservati.

Ristampato con l'autorizzazione di Pearson Education, Inc. da Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2a edizione di Krzysztof Cwalina and Brad Abrams, pubblicato il 22 ottobre 2008 da Addison-Wesley Professional nella collana Microsoft Windows Development Series.

Vedi anche

• Linee guida per la progettazione di Framework
• Linee guida per l'uso