System.SerializableAttribute 类
方法描述
指示一个类可以序列化。 此类不能被继承。
语法定义(C# System.SerializableAttribute 类 的用法)
[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Enum|AttributeTargets.Delegate, Inherited = false)] [ComVisibleAttribute(true)] public sealed class SerializableAttribute : Attribute
构造函数
| 构造函数名称 | 构造函数描述 |
|---|---|
| SerializableAttribute | 初始化 SerializableAttribute 类的新实例。 |
成员/方法
| 方法名称 | 方法描述 |
|---|---|
| Equals | 基础结构。返回一个值，该值指示此实例是否与指定的对象相等。 （继承自 Attribute。） |
| Finalize | 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 （继承自 Object。） |
| GetHashCode | 返回此实例的哈希代码。 （继承自 Attribute。） |
| GetType | 获取当前实例的 Type。 （继承自 Object。） |
| IsDefaultAttribute | 当在派生类中重写时，指示此实例的值是否是派生类的默认值。 （继承自 Attribute。） |
| Match | 当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。 （继承自 Attribute。） |
| MemberwiseClone | 创建当前 Object 的浅表副本。 （继承自 Object。） |
| ToString | 返回表示当前对象的字符串。 （继承自 Object。） |
提示和注释
将 SerializableAttribute 特性应用于一个类型可指示该类型的实例可以序列化。 如果正在序列化的对象图中的任何类型未应用 SerializableAttribute 特性，公共语言运行时则会引发 SerializationException。
即使该类也会实现 ISerializable 接口来控制序列化进程，仍要应用 SerializableAttribute 特性。
默认情况下，类型中由 SerializableAttribute 标记的所有公共和私有字段都会进行序列化，除非该类型实现 ISerializable 接口来重写序列化进程。 默认的序列化进程会排除用 NonSerializedAttribute 特性标记的字段。 如果可序列化类型的字段包含指针、句柄或其他某些针对于特定环境的数据结构，并且不能在不同的环境中以有意义的方式重建，则最好将 NonSerializedAttribute 特性应用于该字段。
有关使用特性的更多信息，请参见 利用特性扩展元数据。 有关序列化的更多信息，请参见 System.Runtime.Serialization。
System.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);
}
}
线程安全
此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。