适用于： 画布应用 桌面流 模型驱动应用 Power Platform CLI

查找 表 中的一个或多个 记录 。

观看此视频，了解如何使用 Filter 、**Search 和 LookUp 函数：

PAC CLI pac power-fx 命令 不支持 搜索 函数。

Filter 函数查找表中满足公式的记录。 使用 Filter 可查找匹配一个或多个条件的一组记录并丢弃不匹配的记录。

LookUp 函数查找表中满足公式的第一条记录。 使用 LookUp 可查找匹配一个或多个条件的单个记录。

对于这两者，系统都会针对表的每条记录计算公式。 结果为 true 的记录将包含在结果中。 除常规公式 运算符 外，还可对子字符串匹配项使用 in 和 exactin 运算符。

当前正在处理的记录的字段在公式中可用。 可以使用 ThisRecord 运算符 ，也可以只按名称引用字段，就像引用任何其他值一样。 As 运算符 也可用于为正在处理的记录命名，从而使您的公式更易于理解，并且使嵌套记录可以被访问。 有关详细信息，请参阅以下示例和 使用记录范围 。

Search 函数在表中查找其某个列中包含某个字符串的记录。 字符串可能出现在列中的任何位置；例如，搜索“rob”或“bert”会在包含“Robert”的列中找到匹配项。 搜索不区分大小写。 与 Filter 和 LookUp 不同， Search 函数使用单个字符串而非公式进行匹配。

Filter 和 Search 返回包含与原始表相同的列的表和匹配条件的记录。 LookUp 用公式将记录归约为单个值后，仅返回找到的第一条记录。 如果未找到记录， Filter 和 Search 将返回 空 表， LookUp 将返回 空白 。

表 是 Power Apps 中的一个值，与字符串或数字类似。 可以向函数传递表，也可以从函数返回表。 Filter 、 Search 和 LookUp 不会修改表。 相反，它们将表作为参数，并从中返回表、记录或单个值。 请参阅 使用表 ，了解更多详细信息。

如果可能，Power Apps 会将筛选和排序操作委派给数据源，并根据需要在结果中翻页。 例如，当您启动一个应用程序来显示填充了数据的 库 控件时，最初只会将第一组记录导入到设备中。 当用户滚动时，会将数据源中的其他数据转入下页。 这样，应用程序的启动时间更短，并且可以访问非常大的数据集。

但是，可能并非总是可以进行委派。 各数据源对委派支持的函数和运算符可能有所不同。 如果无法进行完全公式委派，则创作环境将用一条警告来标记无法委派的部分。 如果可能，请考虑更改公式以避免出现无法委派的函数和运算符。 委派列表 详细说明了可以委派的数据源和操作。

如果无法进行委派，则 Power Apps 将仅拉取一小部分记录以在本地进行处理。 筛选和排序函数将对少数一部分记录进行操作。 库 中提供的内容可能不是整个过程，这可能会使用户感到困惑。

有关详细信息，请参阅 委派概述 。

Filter (Table*, Formula1 [, *Formula2*, ... ] )

Search (Table*, SearchString , Column1 [, *Column2*, ... ] )

在 Power Apps 3.24042 之前的版本中， Search 函数的列名是使用双引号的文本字符串指定的，如果连接到数据源，它们也需要是逻辑名称。 例如，使用带双引号的逻辑名称 "cr43e_name" ，而不是不带引号的显示名称 Name 。 对于列名称带空格的 SharePoint 和 Excel 数据源，每个空格都用 "_x0020_" 指定，例如 "Column Name" 为 "Column_x0020_Name" 。 在此版本之后，所有应用程序都自动更新到本文描述的新语法。

LookUp (Table*, Formula [, *ReductionFormula* ] )

以下示例使用 IceCream 数据源 ：

使用选择列筛选

以下示例使用 Microsoft Dataverse 中的 客户 表作为数据源。 本示例将演示如何根据选定的 Combo box 控件值 筛选 客户列表：

Filter(Accounts,
 'Industry' = ComboBox3.Selected.Industry Or IsBlank(ComboBox3.Selected.Industry),
 'Relationship Type' = ComboBox2.Selected.'Relationship Type' Or
   IsBlank(ComboBox2.Selected.'Relationship Type'),
 'Preferred Method of Contact' = ComboBox1.Selected.'Preferred Method of Contact' Or
   IsBlank(ComboBox1.Selected.'Preferred Method of Contact'))
搜索用户体验
以下示例使用 IceCream数据源：
在许多应用中，您可在搜索框中键入一个或多个字符来对较大数据集中的记录列表进行筛选。 键入时，列表中仅显示与搜索条件匹配的记录。
本文其余部分中的示例演示了搜索包含此数据的列表（名为客户）的结果：
若要将此数据源创建为集合，请创建一个 Button 控件，并将其 OnSelect 属性设置为以下公式：
ClearCollect(Customers, Table({ Name: "Fred Garcia", Company: "Northwind Traders" }, { Name: "Cole Miller", Company: "Contoso" }, { Name: "Glenda Johnson", Company: "Contoso" }, { Name: "Mike Collins", Company: "Adventure Works" }, { Name: "Colleen Jones", Company: "Adventure Works" }) )
如此示例中所示，可在屏幕底部的 Gallery 控件中显示记录列表。 在靠近屏幕顶部的位置，可添加名为 SearchInput 的 Text input 控件，以便用户能够指定对哪些记录感兴趣。
当用户在 SearchInput 中键入字符时，系统将自动筛选库中的结果。 在本例中，库被配置为显示客户名称（不是公司名称）以 SearchInput 中的字符序列开头的记录。 如果用户在搜索框中键入 co，库将显示以下结果：
若要基于 Name 列进行筛选，需将 Gallery 控件的 Items 属性设置为以下公式之一：
Filter(Customers, StartsWith(Name, SearchInput.Text) || StartsWith(Company, SearchInput.Text) )
筛选 Customers 数据源，查找 Name 列或 Company 列以搜索字符串（例如 co）开头的记录。 如果任一 StartsWith 函数为 true，则 || 运算符为 true。
Filter(Customers, SearchInput.Text in Name || SearchInput. Text in Company)
筛选 Customers 数据源，查找 Name 列或 Company 列任意位置包含搜索字符串（例如 co）的记录。
Search(Customers, SearchInput.Text, Name, Company)
与使用 in 运算符类似，Search 函数筛选 Customers 数据源，查找 Name 列或 Company 列任意位置包含搜索字符串（例如 co）的记录。 如果希望指定多个列和多个 in 运算符，那么 Search 函数会比 Filter 更易于读取和写入。
			即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。		

        
提交和查看相关反馈