图像属性

项目
03/04/2017

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

包含图象数据的实体记录可以在应用程序内提供唯一体验。作为开发人员，您需要了解如何处理图象数据。

仅有某些系统实体和自定义实体可以支持图像。有关支持图像的系统实体的信息，请参阅实体图像。

在本主题中

支持属性

检索图像数据

上载图像数据

支持属性

对于支持图像属性的实体，实体图像属性的 SchemaName 始终 EntityImage。当图像属性添加到实体中时，会创建一些支持它的附加属性，如果下表所示。

架构名称	属性类型名称	说明
EntityImage_Timestamp	数据类型	该值代表图像上次更新的时间，用于帮助确保在客户端上下载并缓存了图像的最新版本。
EntityImage_URL	字符串类型	用于在客户端中显示实体图像的绝对 URL。该 URL 的组成方式如下： `{0}/image/download.aspx?entity={1}&attribute={2}&id={3}&timestamp={4}` 0：组织 URL 1：实体逻辑名称 2：属性逻辑名称 3：EntityImageId 值。 4：EntityImage_Timestamp 值例如： https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444
EntityImageId	唯一标识符类型	图像的唯一标识符

架构名称

属性类型名称

说明

EntityImage_Timestamp

数据类型

该值代表图像上次更新的时间，用于帮助确保在客户端上下载并缓存了图像的最新版本。

EntityImage_URL

字符串类型

用于在客户端中显示实体图像的绝对 URL。

该 URL 的组成方式如下：

{0}/image/download.aspx?entity={1}&attribute={2}&id={3}&timestamp={4}

0：组织 URL
1：实体逻辑名称
2：属性逻辑名称
3：EntityImageId 值。
4：EntityImage_Timestamp 值

例如：
https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444

EntityImageId

唯一标识符类型

图像的唯一标识符

备注

不使用当前 .NET 程序集的客户端需要包括值为“6.0.0.0”或更高的 SdkClientVersion ，才能接收 ImageAttributeMetadata 属性。详细信息：SdkClientVersion。