PowerApps の Remove および RemoveIf 関数Remove and RemoveIf functions in PowerApps

データ ソースからレコードを削除します。Removes records from a data source.

説明Description

Remove 関数Remove function

Remove 関数を使用して、1 つまたは複数の特定のレコードをデータ ソースから削除します。Use the Remove function to remove a specific record or records from a data source.

コレクションの場合には、レコード全体が一致している必要があります。For collections, the entire record must match. レコードのコピー全部を削除する場合には、All 引数を使用します。この引数を使用しなかった場合には、レコードのコピーが 1 つだけ削除されます。You can use the All argument to remove all copies of a record; otherwise, only one copy of the record is removed.

RemoveIf 関数RemoveIf function

RemoveIf 関数を使用して、1 つの条件または一連の条件に基づき、1 つまたは複数のレコードを削除します。Use the RemoveIf function to remove a record or records based on a condition or a set of conditions. 各条件には、結果が true または false になるものであれば、どのような数式でも指定できます。また、データ ソースのを、名前を使って参照することもできます。Each condition can be any formula that results in a true or false and can reference columns of the data source by name. 各条件はレコードごとに個別に評価され、すべての条件が true と評価された場合にそのレコードが削除されます。Each condition is evaluated individually for each record, and the record is removed if all conditions evaluate to true.

RemoveRemoveIf は、変更後のデータ ソースをテーブルとして返します。Remove and RemoveIf return the modified data source as a table. これらの関数は、いずれも動作の数式内でのみ使用できます。You can use both functions only in behavior formulas.

また、Clear 関数を使用して、データ ソースのすべてのレコードを削除することもできます。You can also use the Clear function to remove all of the records in a data source.

委任Delegation

When used with a data source, these functions can't be delegated. Only the first portion of the data source will be retrieved and then the function applied. The result may not represent the complete story. A blue dot will appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. For more information, see the delegation overview.

構文Syntax

Remove( DataSource, Record1 [, Record2, ... ] [, All ] )Remove( DataSource, Record1 [, Record2, ... ] [, All ] )

  • DataSource – 必須。DataSource – Required. 削除の対象となるレコードが含まれるデータ ソース。The data source that contains the record or records that you want to remove.
  • Record(s) – 必須。Record(s) – Required. 削除する 1 つまたは複数のレコード。The record or records to remove.
  • All – 省略可能。All – Optional. コレクションでは、同じレコードが複数存在することがあります。In a collection, the same record may appear more than once. レコードのコピーをすべて削除するために、All 引数を追加できます。You can add the All argument to remove all copies of the record.

Remove( DataSource, Table [, All ] )Remove( DataSource, Table [, All ] )

  • DataSource – 必須。DataSource – Required. 削除の対象となるレコードが含まれるデータ ソース。The data source that contains the records that you want to remove.
  • Table – 必須。Table – Required. 削除するレコードのテーブル。A table of records to remove.
  • All – 省略可能。All – Optional. コレクションでは、同じレコードが複数存在することがあります。In a collection, the same record may appear more than once. レコードのコピーをすべて削除するために、All 引数を追加できます。You can add the All argument to remove all copies of the record.

RemoveIf( DataSource, Condition [, ... ] )RemoveIf( DataSource, Condition [, ... ] )

  • DataSource – 必須。DataSource – Required. 削除の対象となるレコードが含まれるデータ ソース。The data source that contains the record or records that you want to remove.
  • Condition(s) – 必須。Condition(s) – Required. 削除の対象とするレコードについて評価結果が true となる数式。A formula that evaluates to true for the record or records to remove. 数式では、DataSource の列名を使用できます。You can use column names from the DataSource in the formula. 複数の Condition を指定する場合、削除の対象とするレコードについて、評価結果がすべて true となる必要があります。If you specify multiple Conditions, all must evaluate to true for the record or records to be removed.

Examples

ここで紹介する例では、IceCream という名前のデータ ソースの 1 つまたは複数のレコードを削除します。このデータ ソースは次のテーブルのデータから始まります。In these examples, you'll remove a record or records in a data source that's named IceCream and that starts with the data in this table:

数式Formula 説明Description 結果Result
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
データ ソースの Chocolate レコードを削除します。Removes the Chocolate record from the data source.

IceCream データ ソースの内容が変更されました。The IceCream data source has been modified.
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ) )
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ) )
データ ソースから 2 つのレコードを削除します。Removes two records from the data source.

IceCream データ ソースの内容が変更されました。The IceCream data source has been modified.
RemoveIf( IceCream, Quantity > 150 )RemoveIf( IceCream, Quantity > 150 ) Quantity の値が 150 よりも大きいレコードを対象として削除を実行します。Removes records that have a Quantity that's greater than 150.

IceCream データ ソースの内容が変更されました。The IceCream data source has been modified.
RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" )RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" ) Quantity の値が 150 よりも大きく、FlavorS で始まるレコードを対象として削除を実行します。Removes records that have a Quantity that's greater than 150 and Flavor starts with an S.


IceCream データ ソースの内容が変更されました。The IceCream data source has been modified.
RemoveIf( IceCream, true )RemoveIf( IceCream, true ) データ ソースからすべてのレコードを削除します。Removes all records from the data source.

IceCream データ ソースの内容が変更されました。The IceCream data source has been modified.

ステップ バイ ステップStep by step

  1. Inventory という名前のコレクションをインポートまたは作成し、ギャラリーにデータを表示する方法に関するページの手順に従って、コレクションをギャラリーに表示します。Import or create a collection named Inventory, and show it in a gallery as Show data in a gallery describes.
  2. ギャラリーで、イメージの OnSelect プロパティを次の式に設定します。In the gallery, set the OnSelect property of the image to this expression:
    Remove(Inventory, ThisItem)Remove(Inventory, ThisItem)
  3. F5 キーを押し、ギャラリーのイメージを選択します。Press F5, and then select an image in the gallery.
    ギャラリーとコレクションから項目が削除されます。The item is removed from the gallery and the collection.