次の方法で共有

First、FirstN、Index、Last、LastN 関数

  • [アーティクル]

適用対象: キャンバス アプリ デスクトップ フロー モデル駆動型アプリ Power Pages Power Platform CLI

最初、最後、または特定の レコード、またはテーブルからの最初または最後のレコードのセットを返します。

説明設定

First 関数は、テーブル の最初のレコードを返します。

FirstN 関数は、テーブルの最初のレコードのセットを返します。2 番目の引数は返されるレコードの数を指定します。

Last 関数は、テーブルの最後のレコードを返します。

LastN 関数は、テーブルの最後のレコードのセットを返します。2 番目の引数は返されるレコードの数を指定します。

Index 関数は、テーブル内の順序付けられた位置に基づいてテーブルのレコードを返します。 レコード番号は 1 で始まるため、 First( table ) は Index( table, 1 ) と同じレコードを返します。 Index は、要求されたレコード インデックスが1未満の場合、テーブル内のレコード数より大きい場合、またはテーブルが空の場合にエラーを返します。

First、 Index、および Last は単一のレコードを返します。 FirstN と LastN は、レコードを1つだけ指定した場合でもテーブルを返します。

委任

データ ソースと共に使用する場合、これらの関数は委任できません。 データ ソースの最初の部分のみが取得され、その後にその関数が適用されます。 結果は完全なストーリーを表さない場合があります。 この制限が存在することを知らせ、可能であれば委任できる代替の選択肢に切り替えるように提案する警告が、作成時に表示される場合があります。 詳しくは、「委任の概要」を参照してください。

たとえば、100 万レコードの大きなテーブルを含むデータソースで使用した場合、Last は非委任の制限を受け、データソース全体の最後のレコードは返されません。 同様に、100万レコードのの途中のレコードを要求するために Index を使用すると、非委任制限に基づく範囲外のインデックスであるため、エラーになります。

構文

まず( 表 )
最後( 表 )

  • 表 - 必須。 操作の対象となるテーブル。

FirstN( テーブル [, レコード数 ] )
LastN( テーブル [, レコード数 ] )

  • 表 - 必須。 操作の対象となるテーブル。
  • NumberOfRecords - オプション。 返されるレコードの数。 この引数を指定しない場合は、関数は 1 つのレコードを返します。

インデックス( テーブル、 レコードインデックス )

  • 表 - 必須。 操作の対象となるテーブル。
  • 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 } ) )
式 説明設定 結果
ファースト(アイスクリーム) IceCream の最初のレコードを返します。 { Flavor: "Chocolate", Quantity: 100 }
ラスト(アイスクリーム) IceCream の最後のレコードを返します。 { Flavor: "Pistachio", Quantity: 200 }
インデックス(アイスクリーム, 3) IceCream の 3 番目のレコードを返します。 { Flavor: "Strawberry", Quantity: 300 }
ファーストN(アイスクリーム、2) IceCream の最初の 2 つのレコードを含むテーブルを返します。 Chocolate と Vanilla のレコードを含むテーブル
LastN(アイスクリーム、2) IceCream の最後の 2 つのレコードを含むテーブルを返します。 Mint と Pistachio のレコードを含むテーブル
インデックス(アイスクリーム、4)。数量 テーブルの 4 番目のレコードを返し、Quantity 列を抽出します。 60
インデックス(アイスクリーム, 10) 要求されたレコードがテーブルの範囲を超えているため、エラーを返します。 エラー