First、FirstN、Index、Last 和 LastN 函式

適用於： 畫布應用 桌面流 模型驅動應用 Power Pages Power Platform CLI

從資料表中傳回第一、最後或特定記錄，或是第一個或最後一個記錄。

描述

First 函式會傳回資料表的第一筆記錄。

FirstN 函式會傳回資料表的第一組記錄；第二個引數會指定要傳回的記錄數目。

Last 函式會傳回資料表的最後一筆記錄。

LastN 函式會傳回資料表的最後一組記錄；第二個引數會指定要傳回的記錄數目。

Index 函式會根據其在資料表中的排序來傳回資料表的記錄。 記錄號碼以 1 開頭，因此 First( table ) 將傳回與 Index( table, 1 ) 相同的記錄。 如果請求的記錄索引小於 1、大於表中的記錄數或表為空，則 Index 將返回錯誤。

First、 Index 和 Last 返回單個記錄。 FirstN 和 LastN 返回一個表，即使您只指定一條記錄也是如此。

委派

搭配資料來源使用時，無法委派這些函式。 將僅擷取資料來源的第一個部分，然後再套用函式。 結果不一定代表完整的全貌。 製作期間可能會出現警告，提醒您有此限制並建議盡可能切換至可委派的替代函式。 如需詳細資訊，請參閱委派概觀。

例如，當與包含一百萬個記錄之大型表格的資料來源一起使用時，Last 將受非委派限制，且不會傳回整個資料來源的最後一個記錄。 同樣地，在一百萬個記錄中間，使用 Index 來要求記錄將會造成錯誤，因為索引超出非委派限制範圍。

語法

First（ 表 ）
上一個（ 表 ）

• Table - 必需。 要作業的資料表。

FirstN（ 表 [， NumberOfRecords ]）
LastN（ 表 [， 記錄數 ]）

• Table - 必需。 要作業的資料表。
• NumberOfRecords - 可選。 要傳回的記錄筆數。 如果您未指定這個引數，函式會傳回一筆記錄。

索引（ Table，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: "Chocolate", Quantity: 100 }
Last（IceCream）	傳回 IceCream 的最後一個記錄。	{ Flavor: "Pistachio", Quantity: 200 }
指數（IceCream，3）	傳回 IceCream 的第三個記錄。	{ Flavor: "Strawberry", Quantity: 300 }
FirstN（霜淇淋，2）	傳回包含 IceCream 的前兩個記錄的資料表。
LastN（霜淇淋，2）	傳回包含 IceCream 的後兩個記錄的資料表。
指數 (IceCream，4).數量	傳回資料表的第四個記錄，並擷取 [數量] 資料行。	60
指數（IceCream，10）	因為要求的記錄超出資料表的範圍，所以會傳回錯誤。	錯誤