图像属性
发布日期: 2017年1月
适用于: Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online
包含图象数据的实体记录可以在应用程序内提供唯一体验。 作为开发人员,您需要了解如何处理图象数据。
仅有某些系统实体和自定义实体可以支持图像。 有关支持图像的系统实体的信息,请参阅 实体图像。
在本主题中
支持属性
检索图像数据
上载图像数据
支持属性
对于支持图像属性的实体,实体图像属性的 SchemaName 始终 EntityImage。 当图像属性添加到实体中时,会创建一些支持它的附加属性,如果下表所示。
架构名称 |
属性类型名称 |
说明 |
---|---|---|
EntityImage_Timestamp |
数据类型 |
该值代表图像上次更新的时间,用于帮助确保在客户端上下载并缓存了图像的最新版本。 |
EntityImage_URL |
字符串类型 |
用于在客户端中显示实体图像的绝对 URL。 该 URL 的组成方式如下:
例如: |
EntityImageId |
唯一标识符类型 |
图像的唯一标识符 |
备注
不使用当前 .NET 程序集的客户端需要包括值为“6.0.0.0”或更高的 SdkClientVersion ,才能接收 ImageAttributeMetadata 属性。详细信息:SdkClientVersion。
检索图像数据
在使用 RetrieveMultiple 或 Retrieve 时,如果 ColumnSet。AllColumns 属性设置为 true,则不包括 EntityImage。 由于此属性的潜在数据大小,如要返回此属性,您必须明确请求它。
如果使用弃用的 ExecuteFetchRequest 类,该代表图像的二进制数据将不被返回。 应该使用 RetrieveMultipleRequest。
详细信息:示例:设置和检索实体图像。
上载图像数据
若要更新图像,请将 EntityImage 的值设置为包含文件内容的 byte[]。 所有图片都以 144x144 像素正方形显示。 在保存之前,图像将进行裁剪并调整大小以降低数据的大小。
至少有一边大于 144 像素的图像将在中心裁剪到 144x144。
两边小于 144 的图像将裁剪到正方形最小边。
下表显示了两个示例。
早于 |
晚于 |
---|---|
300x428 |
144x144 |
91x130 |
91x91 |
详细信息:示例:设置和检索实体图像。
另请参阅
在 Microsoft Dynamics 365 中引入实体
Microsoft Dynamics 365 中的实体属性简介
示例:设置和检索实体图像
Microsoft Dynamics 365
© 2017 Microsoft。 保留所有权利。 版权