当你使用添加服务引用对话框,可以使用开放式数据协议 (OData)馈送基于.NET Framework 的客户端应用程序中,等效的数据类生成的源公开的数据模型中每个实体类型。 有关详细信息,请参阅生成数据服务客户端库。 查询返回的实体数据将具体化为所生成的客户端数据服务类之一的实例。 合并选项和标识解析的被跟踪的对象有关的信息,请参阅管理数据服务上下文。
WCF 数据服务 还允许您定义自己的客户端数据服务类,而不是使用工具生成的数据类。 这样您便可以使用自己的数据类,也称为“纯旧式 CLR 对象”(POCO) 数据类。 使用这些类型的自定义数据类时,应属性数据类具有xref:System.Data.Services.Common.DataServiceKeyAttribute或xref:System.Data.Services.Common.DataServiceEntityAttribute,并确保上的数据服务数据模型中的客户端匹配类型名称的类型名称。
在库收到查询响应消息后,它将从返回的数据具体化OData馈送到客户端数据的实例的查询的类型的服务类。 以下是具体化这些对象的一般过程:
-
客户端库从响应消息源中的
entry元素读取序列化的类型,并尝试采用以下方法之一创建正确类型的新实例:-
当在源中声明的类型与 xref:System.Data.Services.Client.DataServiceQuery`1 的类型具有相同的名称时,会使用空的构造函数创建此类型的新实例。
-
当在源中声明的类型与从 xref:System.Data.Services.Client.DataServiceQuery`1 的类型派生的类型具有相同的名称时,会使用空的构造函数创建此派生类型的新实例。
-
当在源中声明的类型无法与 xref:System.Data.Services.Client.DataServiceQuery`1 的类型或任何派生的类型相匹配时,会使用空的构造函数创建所查询类型的新实例。
-
设置 xref:System.Data.Services.Client.DataServiceContext.ResolveType* 属性时,会调用提供的委托来重写基于默认名称的类型映射,并改为创建由 xref:System.Func`2 返回的类型的新实例。 如果此委托返回一个 null 值,则改为创建所查询类型的新实例。 可能需要重写基于默认名称的类型名称映射以支持继承方案。
-
-
客户端库从
id的entry元素中读取 URI 值,它是实体的标识值。 除非使用 xref:System.Data.Services.Client.DataServiceContext.MergeOption* 的 xref:System.Data.Services.Client.MergeOption.NoTracking 值,否则将使用标识值来跟踪 xref:System.Data.Services.Client.DataServiceContext 中的对象。 该标识值还用于保证仅创建一个实体实例,即使某个实体在查询响应中返回多次。 -
客户端库从源项中读取属性并对新创建的对象设置相应的属性。 如果具有相同标识值的对象已出现在 xref:System.Data.Services.Client.DataServiceContext 中,则根据 xref:System.Data.Services.Client.MergeOption 的 xref:System.Data.Services.Client.DataServiceContext 设置来设定这些属性。 响应可能包含其相应属性不出现在客户端类型中的属性值。 发生这种情况时,将根据 xref:System.Data.Services.Client.DataServiceContext.IgnoreMissingProperties* 的 xref:System.Data.Services.Client.DataServiceContext 属性的值采取操作。 当此属性设置为
true时,忽略缺少的属性。 否则将引发错误。 按如下方式设置这些属性:-
将标量属性设置为响应消息中该项的相应值。
-
将复杂属性设置为新的复杂类型实例,其中使用响应中的复杂类型的属性设置这些属性。
-
将返回相关实体集合的导航属性设置为 xref:System.Collections.Generic.ICollection`1 的新实例或现有实例,其中
T是相关实体的类型。 除非相关对象已加载到 xref:System.Data.Services.Client.DataServiceContext 中,否则此集合是空的。 有关详细信息,请参阅加载延迟的内容。NOTE 当生成的客户端数据类支持数据绑定时,导航属性改为返回 xref:System.Data.Services.Client.DataServiceCollection`1 类的实例。 有关详细信息,请参阅数据绑定到控件。
-
-
引发 xref:System.Data.Services.Client.DataServiceContext.ReadingEntity 事件。
-
客户端库将该对象附加到 xref:System.Data.Services.Client.DataServiceContext。 当 xref:System.Data.Services.Client.MergeOption 为 xref:System.Data.Services.Client.MergeOption.NoTracking 时不附加该对象。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
