First、FirstN、Index、Last 和 LastN 函式

發行項
03/22/2024

適用於： 畫布應用程式桌面流程模型導向應用程式 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 )
Last( Table )

Table – 必要。要作業的資料表。

FirstN( Table [, NumberOfRecords ] )
LastN( Table [, NumberOfRecords ] )

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

Index( Table, RecordIndex )

Table – 必要。要作業的資料表。
RecordIndex - 必要項目。要傳回之記錄的索引。記錄號碼從 1 開始。

範例

在接下來的幾個範例中，我們將使用 IceCream資料來源，其中包含此資料表中的資料：

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

First、FirstN、Index、Last 和 LastN 函式

描述

委派

語法

範例

其他資源