技术客首页
     搜索

WCF Data Contract之集合类型(1)

2008-06-25 17:14:23.0     浏览:1038     来源:e800.net频道
关键词：  WCF      WCF     Contract     集合类型     集合  

在.Net中将实现了IEnumerable接口的所有类型（包括数组和泛型）都称之为集合类型。把其中实现了IDictionary接口或泛型IDictionary接口的集合类型称为字典集合，剩下的其他集合类型为列表集合。

1、集合的数据契约（协定）缺省名称

缺省情况下，WCF框架对集合类型是内建支持的，也就说你不需要应用任何属性，就可以将集合应用在数据契约（协定）中，但前提是集合中的元素必须是应用了DataContractAttribute属性或者是可序列化的类型。这时，数据契约（协定）名称和命名空间就依赖集合中包含的元素的类型的名称和命名空间了，它们不受集合类型本身的名称和命名空间的影响。

缺省集合类型数据契约（协定）的格式是（不包括“+”）：

列表集合：
名称：ArrayOf+集合中包含的元素类型
循环元素名称：集合中包含的元素类型

字典集合：
 名称：ArrayOfKeyValueOf+集合中Key的类型+集合中包含的对象类型
循环元素名称：KeyValueOf+集合中Key的类型+集合中包含的对象类型

例如：

MyCollection1 : IList{…}的数据契约名称就是：ArrayOfint

MyCollection2 : ICollection{…}的数据契约名称就是：ArrayOfint

MyDictionary1 : Dictionary{…}的数据契约名称就是：ArrayOfKeyValueOfintint

MyCollection3 : ArrayList{…}的数据契约名称就是：ArrayOfanyType

MyDictionary2 : Dictionary{…}的数据契约名称就是：ArrayOfKeyValueOfintanyType

注意：如果是object的话，使用的是anyType,因为在Schema中所有类型的基类是anyType。

如果集合是应用于某个数据契约类型中时，那么它的名称将是字段名称，如下面Customer的定义以及序列化后的表示：

[DataContract]
public class Customer
{ 
[DataMember]
public List addresses = new List {"Beijing","ShangHai" };
[DataMember]
public Dictionary telephones = new Dictionary {
{ 1, "010-82371234" }, 
{ 2, "021-56781234" } };
} 
http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://schemas.datacontract.org/2004/07/WCFTestSerializer">
http://schemas.microsoft.com/2003/10/Serialization/Arrays">
Beijing
ShangHai

xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">

1             
http://www.w3.org/2001/XMLSchema" 
i:type="d4p1:string">010-82371234


2
http://www.w3.org/2001/XMLSchema" 
i:type="d4p1:string">021-56781234


2、集合的契约等价

在WCF中应用了CollectionDataContractAttribute属性的集合称之为定制数据契约集合，否则为非定制数据契约集合。不管是非定制数据契约集合还是定制数据契约集合，只要它们的数据契约名称和循环元素的名称都相同（如果是字典集合其Key和Value也要是相同的），我们就说它们是等价的。由于非定制数据契约集合的数据契约以及循环元素的名称由集合中的类型决定，所以非定制数据契约集合的数据契约等价遵守以下几个规则（关于数据契约等价的其他详细信息请参见我以前的文章：WCF Data Contract之契约等价）：

2.1、相同类型的列表集合被认为具有相同的数据契约（协定）例如：List和int[]是等价的。

2.2、具有相同相同键和值类型的所有字典集合也被视为具有相同的数据契约（协定）

2.3、接口和实现该接口的具体集合类的数据契约是等价的。例如IList和List等价。

2.4、非泛型集合与Object类型的泛型集合的数据契约等价。例如：List与ArrayList等价，ArrayList与Object[]也是等价的。

这就是为什么上面的示例中，实现IList和ICollection的集合类型的数据契约名称都是ArrayOfint的原因。例如下面两个数据契约是等价的：

[DataContract(Name="Customer")] public class Customer1
{
[DataMember] public string customerName;
[DataMember] public Collection addresses;
[DataMember] public string[] telephones;
}
[DataContract(Name="Customer")] public class Customer2
{
[DataMember] public string customerName;
[DataMember] public ICollection addresses;
[DataMember] public List telephones;
}

注意：Collection和ICollection是等价的，同时string[]和List也是等价的。

所以，针对Customer2的定义，我们可以将实现ICollection接口的任何集合类的实例赋给addresses。同样，我们也可以利用在数据契约中定义集合接口的机制来将WCF不支持的集合类型（如：ReadOnlyCollection，具体见本文中WCF中对集合类型的要求限制一节）来应用到我们的WCF应用中。也就是说我们可以将ReadOnlyCollection的实例赋给Customer2的addresses。

[第1页]   [第2页]   [下一页]
    热点时讯
    热点技术
    专题