SerializableAttribute Classe

Definizione

Spazio dei nomi:

System

Assembly:

netstandard.dll, System.Runtime.dll

Origine:

SerializableAttribute.cs

Indica che una classe può essere serializzata utilizzando la serializzazione binaria o XML. La classe non può essere ereditata.

C#

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Delegate | System.AttributeTargets.Enum | System.AttributeTargets.Struct, Inherited=false)]
public sealed class SerializableAttribute : Attribute

Ereditarietà

Object

Attribute

SerializableAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene illustrata la serializzazione SOAP di un oggetto contrassegnato con l'attributo SerializableAttribute .

C#

using System;
using System.IO;
using System.Runtime.Serialization.Formatters.Soap;

public class Test {
   public static void Main()  {

      // Creates a new TestSimpleObject object.
      TestSimpleObject obj = new TestSimpleObject();

      Console.WriteLine("Before serialization the object contains: ");
      obj.Print();

      // Opens a file and serializes the object into it in binary format.
      Stream stream = File.Open("data.xml", FileMode.Create);
      SoapFormatter formatter = new SoapFormatter();

      formatter.Serialize(stream, obj);
      stream.Close();

      // Empties obj.
      obj = null;

      // Opens file "data.xml" and deserializes the object from it.
      stream = File.Open("data.xml", FileMode.Open);
      formatter = new SoapFormatter();

      obj = (TestSimpleObject)formatter.Deserialize(stream);
      stream.Close();

      Console.WriteLine("");
      Console.WriteLine("After deserialization the object contains: ");
      obj.Print();
   }
}

// A test object that needs to be serialized.
[Serializable()]
public class TestSimpleObject  {

    public int member1;
    public string member2;
    public string member3;
    public double member4;

    // A field that is not serialized.
    [NonSerialized()] public string member5;

    public TestSimpleObject() {

        member1 = 11;
        member2 = "hello";
        member3 = "hello";
        member4 = 3.14159265;
        member5 = "hello world!";
    }

    public void Print() {

        Console.WriteLine("member1 = '{0}'", member1);
        Console.WriteLine("member2 = '{0}'", member2);
        Console.WriteLine("member3 = '{0}'", member3);
        Console.WriteLine("member4 = '{0}'", member4);
        Console.WriteLine("member5 = '{0}'", member5);
    }
}

Commenti

Applicare l'attributo SerializableAttribute a un tipo per indicare che le istanze di questo tipo possono essere serializzate tramite serializzazione binaria o XML. Common Language Runtime genera SerializationException un'eccezione se un tipo nel grafico degli oggetti serializzati non ha l'attributo SerializableAttribute applicato.

Applicare l'attributo SerializableAttribute anche se la classe implementa anche l'interfaccia ISerializable per controllare il processo di serializzazione binaria.

Quando si applica l'attributo SerializableAttribute a un tipo, tutti i campi pubblici e privati vengono serializzati per impostazione predefinita. È possibile controllare la serializzazione binaria in modo più granulare implementando l'interfaccia per eseguire l'override ISerializable del processo di serializzazione.

In alternativa, è possibile escludere i campi dalla serializzazione applicando l'attributo NonSerializedAttribute al campo. Se un campo di un tipo serializzabile binario contiene un puntatore, un handle o un'altra struttura di dati specifica per un particolare ambiente e non può essere ricostituita in modo significativo in un ambiente diverso, è possibile applicare l'attributo NonSerializedAttribute a tale campo.

Per altre informazioni sull'uso degli attributi, vedere Attributi. Per altre informazioni sulla serializzazione binaria, vedere System.Runtime.Serialization.

Nota

Questo attributo non si applica alla serializzazione JSON tramite System.Text.Json.

Costruttori

SerializableAttribute()

Inizializza una nuova istanza della classe SerializableAttribute.

Proprietà

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a

Vedi anche

• Attribute
• ISerializable
• NonSerializedAttribute
• Estensione di metadati mediante attributi
• Serializzazione XML e SOAP