大网数据广告活动
.NET 与 C# 开发

对象具体化(WCF 数据服务)

· 52CE 我爱测

当你使用添加服务引用对话框,可以使用!INCLUDE[ssODataFull]馈送基于.NET Framework 的客户端应用程序中,等效的数据类生成的源公开的数据模型中每个实体类型。 有关详细信息,请参阅生成数据服务客户端库。 查询返回的实体数据将具体化为所生成的客户端数据服务类之一的实例。 合并选项和标识解析的被跟踪的对象有关的信息,请参阅管理数据服务上下文。

当你使用添加服务引用对话框,可以使用开放式数据协议 (OData)馈送基于.NET Framework 的客户端应用程序中,等效的数据类生成的源公开的数据模型中每个实体类型。 有关详细信息,请参阅生成数据服务客户端库。 查询返回的实体数据将具体化为所生成的客户端数据服务类之一的实例。 合并选项和标识解析的被跟踪的对象有关的信息,请参阅管理数据服务上下文。

WCF 数据服务 还允许您定义自己的客户端数据服务类,而不是使用工具生成的数据类。 这样您便可以使用自己的数据类,也称为“纯旧式 CLR 对象”(POCO) 数据类。 使用这些类型的自定义数据类时,应属性数据类具有xref:System.Data.Services.Common.DataServiceKeyAttribute或xref:System.Data.Services.Common.DataServiceEntityAttribute,并确保上的数据服务数据模型中的客户端匹配类型名称的类型名称。

在库收到查询响应消息后,它将从返回的数据具体化OData馈送到客户端数据的实例的查询的类型的服务类。 以下是具体化这些对象的一般过程:

  1. 客户端库从响应消息源中的 entry 元素读取序列化的类型,并尝试采用以下方法之一创建正确类型的新实例:

  2. 客户端库从 id 的 entry 元素中读取 URI 值,它是实体的标识值。 除非使用 xref:System.Data.Services.Client.DataServiceContext.MergeOption* 的 xref:System.Data.Services.Client.MergeOption.NoTracking 值,否则将使用标识值来跟踪 xref:System.Data.Services.Client.DataServiceContext 中的对象。 该标识值还用于保证仅创建一个实体实例,即使某个实体在查询响应中返回多次。

  3. 客户端库从源项中读取属性并对新创建的对象设置相应的属性。 如果具有相同标识值的对象已出现在 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 时,忽略缺少的属性。 否则将引发错误。 按如下方式设置这些属性:

  4. 引发 xref:System.Data.Services.Client.DataServiceContext.ReadingEntity 事件。

  5. 客户端库将该对象附加到 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,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。