Эта статья переведена вручную. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст. |
Перевод
Текст оригинала
|
SerializableAttribute - класс
Указывает на возможность сериализации класса. Этот класс не наследуется.
Сборка: mscorlib (в mscorlib.dll)
Тип SerializableAttribute предоставляет следующие члены.
| Имя | Описание | |
|---|---|---|
|
SerializableAttribute | Инициализирует новый экземпляр класса SerializableAttribute. |
| Имя | Описание | |
|---|---|---|
|
TypeId | При реализации в производном классе возвращает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute.) |
| Имя | Описание | |
|---|---|---|
|
Equals | Инфраструктура. Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute.) |
|
Finalize | Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.) |
|
GetHashCode | Возвращает хеш-код данного экземпляра. (Унаследовано от Attribute.) |
|
GetType | Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.) |
|
IsDefaultAttribute | При переопределении в производном классе показывает, является ли значение данного экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute.) |
|
Match | При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute.) |
|
MemberwiseClone | Создает неполную копию текущего объекта Object. (Унаследовано от Object.) |
|
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); } }
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.