适用于：
画布应用 Copilot Studio Desktop 流 模型驱动应用 Power Platform CLI Dataverse 函数 Power Pages
返回表中的第一个、最后一个或特定记录，或一组第一个或最后一个记录。
说明
该 First 函数返回 表的第一条记录。
该 FirstN 函数返回表的第一组记录;第二个参数指定要返回的记录数。
该 Last 函数返回表的最后一条记录。
该 LastN 函数返回表的最后一组记录;第二个参数指定要返回的记录数。
该 Index 函数根据表中的有序位置返回表的记录。 记录编号从 1 开始，因此 First( table ) 返回与 Index( table, 1 ) 相同的记录。
Index 如果请求的记录索引小于 1、大于表中的记录数或表为空，则返回错误。
First， Index并 Last 返回单个记录。 FirstN 并 LastN 返回一个表，即使只指定单个记录。
代理
与数据源一起使用时，无法委派这些函数。 将仅检索数据源的第一部分，然后应用该函数。 结果并不能代表整个过程。 创作时可能会显示一条警告，以提醒您有此限制，并建议尽可能切换到可委派的替代项。 有关详细信息，请参阅委派概述。
例如，当与包含包含 100 万条记录的大型表的数据源一起使用时， Last 将受到非委派限制，并且不返回整个数据源的最后一条记录。 同样，使用 Index 在 100 万条记录中间请求记录会导致错误，因为索引超出范围，具体取决于非委派限制。
语法
First（ 表 ）
Last（ 表 ）
- Table - 必需。 要运算的表。
FirstN（ 表 [， NumberOfRecords ] ）
LastN（ 表 [， NumberOfRecords ] ）
- Table - 必需。 要运算的表。
- NumberOfRecords - 可选。 要返回的记录数。 如果未指定此参数，函数将返回一条记录。
Index（ 表， RecordIndex ）
- Table - 必需。 要运算的表。
- RecordIndex - 必需。 要返回的记录的索引。 记录编号从 1 开始。
示例
对于以下示例，我们使用包含此表中数据的 IceCream数据源：
可以使用以下公式将此表放入集合中（放入 Button 控件的 OnStart 公式并按下按钮）：
Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
{ Flavor: "Vanilla", Quantity: 200 },
{ Flavor: "Strawberry", Quantity: 300 },
{ Flavor: "Mint Chocolate", Quantity: 60 },
{ Flavor: "Pistachio", Quantity: 200 } ) )
| 公式 | 说明 | 结果 |
|---|---|---|
| First（冰冰） | 返回 IceCream 的第一个记录。 | { 风格： “Chocolate”， Quantity： 100 } |
| Last（冰冰） | 返回 IceCream 的最后一个记录。 | { 风格： “Pistachio”， Quantity： 200 } |
| Index（IceCream，3） | 返回 IceCream 的第三个记录。 | { 风格： “草莓”， 数量： 300 } |
| FirstN（IceCream，2） | 返回包含 IceCream 的前两个记录的表。 |
|
| LastN（IceCream，2） | 返回包含 IceCream 的后两个记录的表。 |
|
| Index（冰，4）。数量 | 返回表的第四个记录，并提取 Quantity 列。 | 60 |
| Index（冰冰，10） | 返回错误，因为请求的记录超出了表的范围。 | 错误 |