数据契约（DataContract）

WCF第一要素就是契约:

服务契约用于声明可用于远程访问的类型。在Interface或class开始处使用服务契约标签.

[ServiceContract]

Public interface Iservice

{

}

接口调用契约的好处:

1. 同一服务类型可以实现多个不相干的服务契约.

2. 有利于版本升级

3. 按照接口隔离原则,让开发人员可以随时修改服务契约.

服务契约的属性与作用:

Name/Namespace定义该服务契约的自定义名称和命名空间，它会反映到WSDL及客户端的导出类中

ConfigurationName设置信息在配置文件中的名称。默认情况下为类的全名（本例为“WCFDemo.IService”）。

SessionMode服务契约的会话方式，允许的值有Allowed、NotAllowed和Required。默认为Allowed值。

CallbackContract设置双工通信时（Duplex）的回调类型。

ProtectionLevel指定消息保护模式，可以对通信的消息进行加密及签名。

使用参数时，例如要指定自定义的Name和 Namespace，可以编写如下的代码。

[ServiceContract(Name=”MyService”,Namespace=”http://microsoft.com/wcf/demo”)]

Interface IService{}

定义为服务契约的接口或类的方法可以被声明为OperationContract（操作契约），只有声明为操 作契约的方法才可以被远程调用

[ServiceContract]

Public interface Iservice

{

[OperationContract]

String SayHello(string name);

}

错误契约（FaultContract）

被标识为FaultContract的方法必须同时已经被声明为OperationContract，否则就没有什么意义。声明一个方法为 FaultContract并指定了响应的类型参数以后，当调用这个方法时产生错误时，就会有一个对应SOAP格式的错误消息返回给调用端

[DataContract]

public class UserFault //自定义错误类

{

[DataMember]

public string Message { get; set; }

[DataMember]

public int UserId { get; set; }

public UserFault(int userId, string msg)

{

this.UserId = userId;

this.Message = msg;

}

}

[ServiceContract]

public interface IUserService

{

[OperationContract]

[FaultContract(typeof(UserFault))]

UserInfo GetUser(int id);

}

public UserInfo GetUser(int id)

{

try{

UserInfo info = new UserInfo();

info.Age = 16;

info.UserName = "陈翔";

return info;

}

catch (Exception e)

{

throw new FaultException<UserFault>(new UserFault(id, e.Message));

}

}

数据契约（DataContract）

[DataContract]

public partial class Userinfo

{

private string _xsid = String.Empty;

/// <summary>

/// 学生编号

/// </summary>

[DataMember(Name="xsid")]

public string Xsid

{

get { return _xsid; }

set { _xsid = value; }

}

}

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

一个类如果声明了DataContract类型,说明类是可以被传送的,且只有成员属性可以被传送.支持Name/Namespace属性[DataContract(Name=”Name”)]

每一个要传送的成员声明为DataMember类型,同样也可以包含Name,Namespace,IsRequired,Order,EmitDefaultvalue属性

需要传送SOAP消息时可以使用[MessageContract] eg:

[MessageContract]

public partial class Userinfo

{

private string _xsid = String.Empty;

private string _njid = String.Empty;

/// <summary>

/// 学生编号

/// </summary>

[MessageBodyMember(

Name="xsid"

Namespace=”http://www.smodi.com”)]

public string Xsid

{

get { return _xsid; }

set { _xsid = value; }

}

/// <summary>

/// 年级编号

/// </summary>

[MessageHeader(

Name="njid"

Namespace=”http://www.smodi.com”)]

public string Njid

{

get { return _njid; }

set { _njid = value; }

}

}

这个可以生成SOAP消息

<s:Envelope>

<s:Header>

<a:Action s:mustUnderstand="1">http:// Userinfo /Action</a:Action>

<h:AuthKey s:mustUnderstand="1" xmlns:h="http://www.smodi.com">xxxx</h:AuthKey>

</s:Header>

<s:Body>

<UserMessage xmlns="Microsoft.WCF.Documentation">

<User xmlns="http://www.smodi.com">abcd</User>

</UserMessage>

</s:Body>

</s:Envelope>