通过


使用 FetchXML 检索数据

可以使用 FetchXml 通过 SDK for .NET 或 Web API 从 Dataverse 检索数据。 通过使用 Power Automate,可以使用 列表行命令的 Fetch Xml Query 参数通过 Web API 检索数据。 使用 PAC CLI,请使用 pac env fetch 命令。

你可能还想要使用社区工具,例如 Power Platform ToolBox 中的 FetchXML Studio,用于 XrmToolBox 中的 FetchXML Builder

检索数据的方式取决于是使用 SDK for .NET 还是 Dataverse Web API

使用 FetchExpression 类将 FetchXml 查询保存为字符串。 FetchExpression 派生自常见的 QueryBase 类 类型,因此,当该类型是方法参数或类属性时,可以使用它。

对于大多数情况,请使用 IOrganizationService.RetrieveMultiple 方法

static EntityCollection RetrieveMultipleExample(IOrganizationService service, string fetchXml)
{
   return service.RetrieveMultiple(new FetchExpression(fetchXml));
}

还可以将 RetrieveMultipleRequest 类IOrganizationService.Execute 方法一起使用,但在少数情况下,有必要使用这种方法。

static EntityCollection RetrieveMultipleRequestExample(IOrganizationService service, string fetchXml)
{
   var request = new RetrieveMultipleRequest()
   {
         Query = new FetchExpression(fetchXml)
   };

   var response = (RetrieveMultipleResponse)service.Execute(request);

   return response.EntityCollection;
}

快速入门:执行用于 .NET 请求的 SDK (C#)
详细了解如何将消息与 SDK for .NET 配合使用

不返回空的列值

当表列包含 null 值或未请求该列时,返回的记录不包括该值。 没有用于访问或返回值的键。 属性的缺失表示其为 null。 使用 SDK for .NET 时,会发生此行为。 详细了解此行为

这些在读取时无效的列始终返回 null 值。 这些列将 AttributeMetadata.IsValidForRead 属性设置为 false。

后续步骤

了解如何选择列。

尝试一些示例代码。