服務契約定義了遠程訪問對象和可供調用的方法,數據契約則是服務端和客戶端之間要傳送的自定義數據類型。
一旦聲明一個類型為DataContract,那么該類型就可以被序列化在服務端和客戶端之間傳送,如下所示。
[DataContract]
public class UserInfo
{
//….
}
只有聲明為DataContract的類型的對象可以被傳送,且只有成員屬性會被傳遞,成員方法不會被傳遞。WCF對聲明為DataContract的類型提供更加細節的控制,可以把一個成員排除在序列化范圍以外,也就是說,客戶端程序不會獲得被排除在外的成員的任何信息,包括定義和數據。默認情況下,所有的成員屬性都被排除在外,因此需要把每一個要傳送的成員聲明為DataMember,如下所示。
[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;
}
}
上面這段代碼把UserInfo類聲明為DataContract,將UserName、Age、Location這3個屬性聲明為DataMember(數據成員)。Zodiac成員沒有被聲明為DataMember,因此在交換數據時,不會傳輸Zodiac的任何信息。
DataContract也支持Name/Namespace屬性,如同ServiceContract,Name和Namespace可以自定義名稱和命名空間,客戶端將使用自定義的名稱和命名空間對DataContract類型進行訪問。
聲明為DataMember的成員也可以自定義客戶端可見的名稱,例如:
[DataMember(Name="Name")]
public string UserName
{
get;
set;
}
[DataMember(Name="Age")]
public int UserAge
{
get;
set;
}
除了Name和Namespace以外,DataMember還有以下參數,它們的含義分別如下。
(1)IsRequired:值為true時,要求序列化引擎檢查對象是否存在該值;若無,則會有異常拋出。
(2)Order:bool類型值,值為true時,序列化和反序列化過程將會按成員定義的順序進行,這對依賴於成員位置的反序列化過程無比重要。
(3)EmitDefaultvalue:為成員屬性設置一個默認值。
一般情況下,將類型聲明為DataContract就可以滿足傳送的需求了,不過特殊情況是難以避免的,這時就需要對要傳送的SOAP消息進行更加精確的控制,MessageContract可以滿足這種需求。
把一個類型聲明為MessageContract,意味着它可以被序列化為SOAP消息,可以聲明類型的成員為SOAP消息的各個部分,如Header、Body等,如下所示。
[MessageContract]
public class UserMessage
{
private string user = String.Empty;
private string authKey = String.Empty;
[MessageBodyMember(
Name = "UserName",
Namespace = "http://www.wcf.com")]
public string User
{
get { return user; }
set { user = value; }
}
[MessageHeader(
Name = "AuthKey",
Namespace = "http://www.wcf.com",
MustUnderstand = true
)]
public string AuthKey
{
get { return authKey; }
set { this.authKey = value; }
}
}
User成員被聲明為MessageBody(消息體)的一個成員,AuthKey被聲明為消息頭(MessageHeader)的一個成員。這個類將可以生成如下的SOAP消息。
<s:Envelope>
<s:Header>
<a:Action s:mustUnderstand="1">http://UserMessage/Action</a:Action>
<h:AuthKey s:mustUnderstand="1" xmlns:h="http://www.wcf.com">xxxx</h:AuthKey>
</s:Header>
<s:Body>
<UserMessage xmlns="Microsoft.WCF.Documentation">
<User xmlns="http://www.wcf.com">abcd</User>
</UserMessage>
</s:Body>
</s:Envelope>
MessageHeader中,MustUnderstand參數表示讀取該頭的程序必須能夠識別頭的內容,否則不能繼續處理。Name/Namespace的作用與前面的元素相同。另有Relay參數,若為true,頭的內容被接收到以后會在響應消息中回發給消息發送端。