適用於：
畫布應用程式 Copilot Studio 桌面流程 模型導向應用程式 Power Platform CLI Dataverse 函數 Power Pages
從資料表中傳回第一、最後或特定記錄，或是第一個或最後一個記錄。
描述
函式會 First 傳回 資料表的第一筆記錄。
函數 FirstN 會傳回資料表的第一組記錄，第二個引數會指定要傳回的記錄數目。
此 Last 函式會傳回資料表的最後一筆記錄。
函數 LastN 會傳回資料表的最後一組記錄，第二個引數會指定要傳回的記錄數目。
函數根據 Index 表格在表格中的排序位置傳回表格的記錄。 記錄號碼以 1 開頭，因此 First( table ) 將傳回與 Index( table, 1 ) 相同的記錄。
Index 如果要求的記錄索引小於 1、大於表格中的記錄數，或表格是空的，則會傳回錯誤。
First、 Index和 ，並 Last 傳回單一記錄。 FirstN 並 LastN 傳回表格，即使您只指定單一記錄也一樣。
委派
搭配資料來源使用時，無法委派這些函式。 將僅擷取資料來源的第一個部分，然後再套用函式。 結果不一定代表完整的全貌。 製作期間可能會出現警告，提醒您有此限制並建議盡可能切換至可委派的替代函式。 如需詳細資訊，請參閱委派概觀。
例如，當與包含具有一百萬筆記錄的大型資料表的資料來源搭配使用時， Last 會受到非委派限制的約束，而且不會傳回整個資料來源的最後一筆記錄。 同樣地，使用 Index 來要求一百萬筆記錄中間的記錄會導致錯誤，因為索引超出了基於非委派限制的範圍。
語法
First（ 表格 ）
Last（ 表格 ）
- Table - 必需。 要作業的資料表。
FirstN（ 表格 [， 記錄數 ] ）
LastN（ 表格 [， 記錄數 ] ）
- 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 的第一個記錄。 | { flavor： “巧克力”， 數量： 100 } |
| Last（ 冰淇淋 ） | 傳回 IceCream 的最後一個記錄。 | { 口味：“開心果”，數量：200 } |
| Index（冰淇淋，3 ） | 傳回 IceCream 的第三個記錄。 | { flavor： “草莓”， 數量： 300 } |
| FirstN（ 冰淇淋， 2 ） | 傳回包含 IceCream 的前兩個記錄的資料表。 |
|
| LastN（ 冰淇淋， 2 ） | 傳回包含 IceCream 的後兩個記錄的資料表。 |
|
| Index（冰淇淋，4 ）。量 | 傳回資料表的第四個記錄，並擷取 [數量] 資料行。 | 60 |
| Index（冰淇淋，10 ） | 因為要求的記錄超出資料表的範圍，所以會傳回錯誤。 | 錯誤 |