数据契约（DataContract）里的DataMember特性

 

数据契约（DataContract） 服务契约定义了远程访问对象和可供调用的方法，数据契约则是服务端和客户端之间要传送的自定义数据类型。

一旦声明一个类型为DataContract，那么该类型就可以被序列化在服务端和客户端之间传送，如下所示。

    [DataContract]
    public class UserInfo

    {
        [DataMember]
        public string UserName { get; set; }

        [DataMember]
        public int Age { get; set; }

        [DataMember]
        public string Location { get; set; }

        public string Zodiac { get; set; }
    }

 

 只有声明为DataContract的类型的对象可以被传送，且只有成员属性会被传递，成员方法不会被传递。WCF对声明为DataContract的类型提供更加细节的控制，可以把一个成员排除在序列化范围以外，也就是说，客户端程序不会获得被排除在外的成员的任何信息，包括定义和数据。默认情况下，所有的成员属性都被排除在外，因此需要把每一个要传送的成员声明为DataMember;

上面这段代码把UserInfo类声明为DataContract，将UserName、Age、Location这3个属性声明为DataMember（数据成员）。Zodiac成员没有被声明为DataMember，因此在交换数据时，不会传输Zodiac的任何信息

声明为DataMember的成员也可以自定义客户端可见的名称

除了Name和Namespace以外，DataMember还有以下参数，它们的含义分别如下。

（1）IsRequired：值为true时，要求序列化引擎检查对象是否存在该值；若无，则会有异常抛出。

（2）Order：bool类型值，值为true时，序列化和反序列化过程将会按成员定义的顺序进行，这对依赖于成员位置的反序列化过程无比重要。

（3）EmitDefaultvalue：为成员属性设置一个默认值。