Эта статья переведена вручную. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст.
Перевод
Текст оригинала
Эта тема еще не получила оценку Оценить эту тему

SerializableAttribute - класс

Указывает на возможность сериализации класса. Этот класс не наследуется.

System.Object
  System.Attribute
    System.SerializableAttribute

Пространство имен:  System
Сборка:  mscorlib (в mscorlib.dll)
[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Enum|AttributeTargets.Delegate, Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class SerializableAttribute : Attribute

Тип SerializableAttribute предоставляет следующие члены.

  Имя Описание
Открытый метод Поддерживается платформой XNA Framework SerializableAttribute Инициализирует новый экземпляр класса SerializableAttribute.
В начало страницы
  Имя Описание
Открытое свойство TypeId При реализации в производном классе возвращает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute.)
В начало страницы
  Имя Описание
Открытый метод Поддерживается платформой XNA Framework Equals Инфраструктура. Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute.)
Защищенный метод Поддерживается платформой XNA Framework Finalize Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
Открытый метод Поддерживается платформой XNA Framework GetHashCode Возвращает хеш-код данного экземпляра. (Унаследовано от Attribute.)
Открытый метод Поддерживается платформой XNA Framework GetType Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
Открытый метод IsDefaultAttribute При переопределении в производном классе показывает, является ли значение данного экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute.)
Открытый метод Поддерживается платформой XNA Framework Match При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute.)
Защищенный метод Поддерживается платформой XNA Framework MemberwiseClone Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
Открытый метод Поддерживается платформой XNA Framework ToString Возвращение строки, представляющей текущий объект. (Унаследовано от Object.)
В начало страницы
  Имя Описание
Явная реализация интерфейса Закрытый метод _Attribute.GetIDsOfNames Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute.)
Явная реализация интерфейса Закрытый метод _Attribute.GetTypeInfo Возвращает сведения о типе объекта, которые могут использоваться для получения сведений о типе интерфейса. (Унаследовано от Attribute.)
Явная реализация интерфейса Закрытый метод _Attribute.GetTypeInfoCount Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute.)
Явная реализация интерфейса Закрытый метод _Attribute.Invoke Предоставляет доступ к открытым свойствам и методам объекта. (Унаследовано от Attribute.)
В начало страницы

Для указания на то, что экземпляры данного типа могут быть сериализованы, примените к типу атрибут SerializableAttribute. Среда CLR выбрасывает исключение SerializationException, если какой-либо тип в диаграмме сериализуемых объектов не имеет атрибута SerializableAttribute.

Применяйте атрибут SerializableAttribute, даже если класс также реализует интерфейс ISerializable для управления процессом сериализации.

Все открытые и служебные поля в типе, помеченные атрибутом SerializableAttribute, по умолчанию сериализуются, если тип не реализует интерфейс ISerializable для переопределения процесса сериализации. Стандартный процесс сериализации исключает поля, помеченные атрибутом NonSerializedAttribute. Если поле сериализуемого типа содержит указатель, дескриптор или некоторые другие структуры данных, специфические для определенной среды, которые нельзя воссоздать в другой среде с получением логически эквивалентного результата, целесообразно применить к этому полю атрибут NonSerializedAttribute.

Дополнительные сведения об использовании атрибутов см. в разделе Расширение метаданных с помощью атрибутов. Дополнительные сведений о сериализации см. в разделе, посвященном пространству имен System.Runtime.Serialization.

В следующем примере демонстрируется сериализация объекта, помеченного атрибутом SerializableAttribute. Для использования BinaryFormatter вместо SoapFormatter снимите комментирование с соответствующих строк.


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

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();

      //BinaryFormatter formatter = new BinaryFormatter();

      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();

      //formatter = new BinaryFormatter();

      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);
    }
}


.NET Framework

Поддерживается в версиях: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework (клиентский профиль)

Поддерживается в версиях: 4, 3.5 SP1

Windows 7, Windows Vista с пакетом обновления 1 (SP1) или выше, Windows XP с пакетом обновления 3 (SP3), 64-разрядный выпуск Windows XP с пакетом обновления 2 (SP2), Windows Server 2008 (Server Core не поддерживается), Windows Server 2008 R2 (Server Core поддерживается с пакетом обновления 1 (SP1) или более поздним), Windows Server 2003 SP2

.NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.
Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.
Была ли вам полезна эта информация?
(2000 символов осталось)
Содержимое сообщества Добавить
Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?