Funkciók eltávolítása és RemoveIf a Power apps szolgáltatásbanRemove and RemoveIf functions in Power Apps

Rekordok eltávolítása az adatforrásból.Removes records from a data source.

Description (Leírás)Description

A Remove függvényRemove function

A Remove függvénnyel egy vagy több adott rekordot távolíthat el az adatforrásból.Use the Remove function to remove a specific record or records from a data source.

Gyűjtemények esetében a teljes rekordnak egyeznie kell.For collections, the entire record must match. Az All argumentum használatával egy adott rekord összes példányát eltávolíthatja, ellenkező esetben csak az egyik példány lesz eltávolítva.You can use the All argument to remove all copies of a record; otherwise, only one copy of the record is removed.

A RemoveIf függvényRemoveIf function

A RemoveIf függvénnyel az egy vagy több megadott feltételnek megfelelő rekordokat távolíthatja el.Use the RemoveIf function to remove a record or records based on a condition or a set of conditions. Az egyes feltételeket bármilyen olyan képlet alkothatja, amely eredménye true vagy false lehet, és név szerint hivatkozhatnak az adatforrás oszlopaira.Each condition can be any formula that results in a true or false and can reference columns of the data source by name. A feltételeket minden rekord esetében egyenként értékeli ki a rendszer és a rekordot akkor távolítja el, ha az összes feltétel true eredményt ad.Each condition is evaluated individually for each record, and the record is removed if all conditions evaluate to true.

A Remove és a RemoveIf függvény tábla formájában adja vissza a módosított adatforrást.Remove and RemoveIf return the modified data source as a table. Mindkét függvény csak viselkedésszabályozó képletekben használható.You can use both functions only in behavior formulas.

A Clear függvényt is használhatja az összes rekord eltávolítására az adatforrásból.You can also use the Clear function to remove all of the records in a data source.

DelegálásDelegation

Adatforrással való használat esetén ezek a funkciók nem delegálhatók.When used with a data source, these functions can't be delegated. Csak az adatforrás első részét kéri le, és utána alkalmazza a funkciót.Only the first portion of the data source will be retrieved and then the function applied. Előfordulhat, hogy az eredmény nem tükrözi a teljes képet.The result may not represent the complete story. A szerkesztés során megjelenhet egy figyelmeztetés, amely emlékezteti erre a korlátozásra, és javasolja, hogy lehetőség szerint váltson delegálható alternatívára.A warning may appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. További információkért lásd: a delegálás áttekintése.For more information, see the delegation overview.

SzintaxisSyntax

Remove( Adatforrás; Rekord 1 [;Rekord 2; ...] [; All ] )Remove( DataSource; Record1 [; Record2; ... ] [; All ] )

  • DataSource – kötelező.DataSource – Required. Az adatforrás, amelyből a rekordot vagy rekordokat eltávolítani szeretné.The data source that contains the record or records that you want to remove.
  • Rekord(ok) – Kötelező megadni.Record(s) – Required. Az eltávolítandó rekord vagy rekordok.The record or records to remove.
  • All – Nem kötelező.All – Optional. Egy gyűjteményben többször is előfordulhat ugyanaz a rekord.In a collection, the same record may appear more than once. Az All argumentummal jelezheti, hogy mindegyik példányt el szeretné távolítani.You can add the All argument to remove all copies of the record.

Remove( Adatforrás; Tábla [; All ] )Remove( DataSource; Table [; All ] )

  • DataSource – kötelező.DataSource – Required. Az adatforrás, amely az eltávolítani kívánt rekordokat tartalmazza.The data source that contains the records that you want to remove.
  • Tábla – Kötelező megadni.Table – Required. Az eltávolítani kívánt rekordtábla.A table of records to remove.
  • All – Nem kötelező.All – Optional. Egy gyűjteményben többször is előfordulhat ugyanaz a rekord.In a collection, the same record may appear more than once. Az All argumentummal jelezheti, hogy mindegyik példányt el szeretné távolítani.You can add the All argument to remove all copies of the record.

RemoveIf( Adatforrás; Feltétel [; ...] )RemoveIf( DataSource; Condition [; ... ] )

  • DataSource – kötelező.DataSource – Required. Az adatforrás, amelyből a rekordot vagy rekordokat eltávolítani szeretné.The data source that contains the record or records that you want to remove.
  • Feltétel(ek) – Kötelező megadni.Condition(s) – Required. Egy olyan képlet, amely igaz eredményt ad az eltávolítandó rekordon vagy rekordokon alkalmazva.A formula that evaluates to true for the record or records to remove. Az adatforrás oszlopnevei is használhatóak a képletben.You can use column names from the DataSource in the formula. Ha több feltételt is megad, mindegyiknek igaz eredményt kell adnia ahhoz, hogy a rekordot vagy rekordokat eltávolítsa a rendszer.If you specify multiple Conditions, all must evaluate to true for the record or records to be removed.

Példák – egyetlen képletExamples - single formulas

A következő példákban rekordokat fogunk eltávolítani az IceCream nevű adatforrásból, amely kezdetben az alábbi táblában látható adatokat tartalmazza: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:

Minta rekordokkal rendelkező gyűjtemény létrehozásaCreate a collection with sample records

Gyűjtemény létrehozása a következő adattal:To create a collection with this data:

  1. Szúrjon be egy gomb vezérlőelemet.Insert a Button control.

  2. Állítsa be a gomb vezérlő OnSelect tulajdonságát az alábbi képletre:Set button control's OnSelect property to the below formula:

    ClearCollect( IceCream;
                  { ID: 1; Flavor: "Chocolate";  Quantity: 100 };
                  { ID: 2; Flavor: "Vanilla";    Quantity: 200 };
                  { ID: 3; Flavor: "Strawberry"; Quantity: 300 }
    )
    
  3. Válassza ki a gombot, miközben lenyomja az ALT billentyűt:Select the button while holding down the Alt key:

Minta rekordok eltávolítása a gyűjteményből képlet használatávalRemove sample records from collection using a formula

FormulaFormula Description (Leírás)Description EredményResult
Remove( IceCream;
First( Filter( IceCream; Flavor="Chocolate" ) ) )
Remove( IceCream;
First( Filter( IceCream; Flavor="Chocolate" ) ) )
Eltávolítja a Chocolate rekordot az adatforrásból.Removes the Chocolate record from the data source.

Az IceCream adatforrás módosult.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" ) ) )
Két rekordot távolít el az adatforrásból.Removes two records from the data source.

Az IceCream adatforrás módosult.The IceCream data source has been modified.
RemoveIf( IceCream; Quantity > 150 )RemoveIf( IceCream; Quantity > 150 ) Eltávolítja azokat a rekordokat, amelyeknél a Quantity több mint 150.Removes records that have a Quantity that's greater than 150.

Az IceCream adatforrás módosult.The IceCream data source has been modified.
RemoveIf( IceCream; Quantity > 150; Left( Flavor; 1 ) = "S" )RemoveIf( IceCream; Quantity > 150; Left( Flavor; 1 ) = "S" ) Eltávolítja azokat a rekordokat, amelyeknél a Quantity több mint 150, és az Flavor S betűvel kezdődik.Removes records that have a Quantity that's greater than 150 and Flavor starts with an S.


Az IceCream adatforrás módosult.The IceCream data source has been modified.
RemoveIf( IceCream; true )RemoveIf( IceCream; true ) Eltávolítja az összes rekordot az adatforrásból.Removes all records from the data source.

Az IceCream adatforrás módosult.The IceCream data source has been modified.

Ebben a példában egy gyűjtemény vezérlőelemet használ a tábla rekordjainak listázásához.In this example, you'll use a Gallery control to list the records in a table. Ezután az Eltávolítás függvénnyel szelektíven távolítsa el az elemeket.And then use the Remove function to selectively remove an item.

Mintaadatok előkészítésePrepare for sample data

Ez a példa a Contacts entitást használja Common Data Service elérhető a minta alkalmazásokkal és az adatbázisokkal.This example uses the Contacts entity in Common Data Service available with the sample apps and data. Környezet létrehozásakortelepítheti a minta alkalmazásokat és az adatbázisokat .You can deploy sample apps and data when you create an environment. Ehelyett bármilyen más adatforrás is használható.You can also use any other data source instead.

Ebben a példában egy, a katalóguson kívüli gomb használatával távolítja el az elemeket.In this example, you'll remove an item by using a button that is outside the gallery.

  1. Új üres vászon alkalmazás létrehozása telefonos elrendezés használatával.Create a new blank canvas app using a Phone layout.

    Üres vászon alkalmazás a telefonos elrendezés használatával

  2. Válassza ki a beszúrást a bal oldali ablaktáblán.Select the Insert from the left pane.

  3. Válassza a függőlegeskatalógus lehetőséget.Select Vertical gallery.
    A képernyőhöz bekerül egy gyűjtemény vezérlőelem.A Gallery control is be added to your screen.

    Függőleges katalógus vezérlőelem hozzáadása az eszköz beszúrása panel használatával

  4. A rendszer arra kéri, hogy válasszon ki egy adatforrást, ahol kiválaszthat egy adatforrást az elérhető adatforrásokból.You're prompted to select a data source where you can select a data source from the available data sources.
    Válassza ki például a névjegyek entitást a mintaadatokhasználatához:For example, select the Contacts entity to use sample data:

    A katalógusban megjelenítendő Contacts entitás kiválasztása

    A gyűjtemény megjeleníti az entitás elemeit:The gallery shows items from this entity:

    A Contacts entitást bemutató gyűjtemény hozzáadva

  5. Gomb vezérlőelem beszúrása a bal oldali panelen:Insert a Button control from left pane:

    Gomb vezérlőelem felvétele az eszköz beszúrása paneljével

  6. Helyezze át a hozzáadott gombot a gyűjtemény elemei alá:Move the added button below the gallery items:

    Mozgatás gomb

  7. A gomb Text tulajdonságának frissítése a rekord eltávolításához.Update button text property to Remove record. Tetszőleges szöveget is használhat:You can also use text of your choice:

    Átnevezés gomb

  8. Állítsa a gomb vezérlőelem OnSelect tulajdonságát a következő képletre:Set the OnSelect property for this button control to the following formula:

    Remove( Contacts; Gallery1.Selected )
    

    A gomb vezérlőelem OnSelect tulajdonságának beállítása

    A gyűjtemény vezérlőelem lehetővé teszi, hogy a jelenleg kijelölt rekord elérhető legyen a kiválasztott tulajdonság használatával.The gallery control makes the currently selected record available using Selected property. A Remove függvény erre a kijelölt rekordra hivatkozik az eltávolításához.Remove function refers to this selected record to remove it.

  9. Tekintse meg az alkalmazást a jobb felső sarokban található Lejátszás gomb használatával, vagy nyomja le az F5 billentyűt a billentyűzeten:Preview the app using the Play button on the top right, or press F5 on keyboard:

    Alkalmazás előnézete

  10. Válassza ki az eltávolítandó rekordot, például Nancyrekordját ebben a példában:Select a record to remove, such as Nancy's record in this example:

    Rekord kiválasztása

  11. Válassza a rekord eltávolításalehetőséget:Select Remove record:

    A névjegyek katalógusa, mostantól a Nancy-rekord eltávolítása nélkül

    A gomb kiválasztásával eltávolítja a kijelölt rekordot (ebben a példában a Nancy rekordját).Selecting the button removes the selected record (in this example, Nancy's record).

  12. Az alkalmazás előzetes verziójának lezárása.Close the app preview.

    Tipp

    Alternatív viselkedést is használhat az ALT billentyűvel az alkalmazás előnézetének Lejátszás gomb vagy F5használatával történő használata helyett.You can also use alternate behavior with Alt key instead of using the app preview with Play button or F5.

Ebben a példában egy, a katalógusban elhelyezett ikon használatával távolítja el az elemeket.In this example, you'll remove an item by using an icon placed inside the gallery.

Adathalmaz létrehozása mintaadatokbőlCreate a collection with sample data

Ha már előkészített mintaadatokis vannak, ugorja át ezt a lépést, és váltson a Kuka ikonra akatalóguson belül.If you already have prepared sample data, skip this step and move to Trash can icon inside a gallery.

  1. Adjon hozzá egy gomb vezérlőt a képernyőhöz.Add a Button control to your screen.

  2. Az OnSelect (Kiválasztáskor) tulajdonság értékeként adja meg a következő képletet:Set the OnSelect property to the following formula:

    ClearCollect( SampleContacts; 
          { 'Full Name': "Yvonne McKay (sample)";      'Primary Email': "someone_a@example.com" };
          { 'Full Name': "Susanna Stubberod (sample)"; 'Primary Email': "someone_b@example.com" };
          { 'Full Name': "Nancy Anderson (sample)";    'Primary Email': "someone_c@example.com" };
          { 'Full Name': "Maria Campbell (sample)";    'Primary Email': "someone_d@example.com" };
          { 'Full Name': "Robert Lyon (sample)";       'Primary Email': "someone_e@example.com" };
          { 'Full Name': "Paul Cannon (sample)";       'Primary Email': "someone_f@example.com" };
          { 'Full Name': "Rene Valdes (sample)";       'Primary Email': "someone_g@example.com" } 
    )
    
  3. Válassza ki a gombot, miközben lenyomja az ALT billentyűt.Select the button while holding down the Alt key.

A rendszer létrehoz egy minta-gyűjteményt, amelyet a következő példában is használhat.Sample collection is created that you can use in the following example.

  1. Új üres vászon alkalmazás létrehozása telefonos elrendezés használatával.Create a new blank canvas app using a Phone layout.

    Üres vászon alkalmazás a telefonos elrendezés használatával

  2. Válassza ki a beszúrást a bal oldali ablaktáblán.Select the Insert from the left pane.

  3. Válassza a függőlegeskatalógus lehetőséget.Select Vertical gallery.
    A képernyőhöz bekerül egy gyűjtemény vezérlőelem.A Gallery control is be added to your screen.

    Függőleges katalógus vezérlőelem hozzáadása az eszköz beszúrása panel használatával

  4. A rendszer arra kéri, hogy válasszon ki egy adatforrást, ahol kiválaszthat egy adatforrást az elérhető adatforrásokból.You're prompted to select a data source where you can select a data source from the available data sources.
    Válassza ki például a névjegyek entitást a mintaadatokhasználatához:For example, select the Contacts entity to use sample data:

    A katalógusban megjelenítendő Contacts entitás kiválasztása

    Ha létrehozott egy gyűjteményt, válassza ki a gyűjteményt:If you created a collection, select your collection instead:

    Minta névjegyek gyűjteménye

  5. Jelöljön ki egy vezérlőelemet a katalógus legfelső elemén belül.Select a control within the top item in the gallery.

    A következő lépésre való áttérés előtt győződjön meg arról, hogy a következő lépés beszúrja az elemet a katalógus sablonjában, és nem a katalóguson kívülre.To ensure next step inserts item into gallery's template and not outside the gallery, ensure you follow this step before moving to the next step.

    Legfelső szintű rekord kiválasztása egy gyűjteményben

  6. Válassza a Hozzáadás ikont a bal oldali panelen.Select Add icon from left pane.

    Ikon vezérlőelem hozzáadása az eszköz beszúrása panel használatával

    Megjegyzés

    A Hozzáadás ikon beszúr egy + ikont a katalógus bal oldalán, amely a katalógus minden elemére replikálva van.Add icon inserts a + icon on the left side of the gallery, replicated for each item in the gallery.

  7. A felső elemben mozgassa az ikont a képernyő jobb oldalára.In the top item, move the icon to the right side of the screen.

    Ikon áthelyezése

  8. Válassza a Icon ( ikon ) tulajdonságot a ikonhoz, és állítsa be a következő képletre az ikon rendszerképének a Kuka ikonként való frissítéséhez:Select the Icon property for icon and set it to the following formula to update the icon image as trash icon:

    Icon.Trash
    

    Megjegyzés

    Az ikon.The Icon. az előtag csak akkor jelenik meg, ha aktívan szerkeszti a képletet.prefix is only shown when you're actively editing the formula.

    A Kuka ikonjának módosítása ikon

  9. Az OnSelect (Kiválasztáskor) tulajdonság értékeként adja meg a következő képletet:Set the OnSelect property to the following formula:

    Remove( [@Contacts]; ThisItem )
    

    Megjegyzés

    Globálisan felhasználható operátort kell használni [@ ... ] ebben a példában a Contacts entitást használó mintaadatok használatával elkerülhető az egy -a-többhöz típusú kapcsolattal való ütközés.You must use global disambiguation operator [@...] in this example with sample data that uses the Contacts entity to avoid conflict with a One-to-Many relationship. Ha olyan adatforrásokat használ, mint például a SharePoint-lista vagy a SQL Server-tábla, a globális disambgulation operátor használata nem szükséges.If you use data sources such as a SharePoint list or a SQL Server table, using global disambgulation operator is not required.

    OnSelect a Kuka ikonhoz

  10. Tekintse meg az alkalmazást a jobb felső sarokban található Lejátszás gomb használatával, vagy nyomja le az F5 billentyűt a billentyűzeten.Preview the app using the Play button on the top right, or press F5 on keyboard.

  11. Válassza a Kuka ikont a rekord mellett, például Maria:Select the trash icon next to a record, for example Maria's:

    Katalógus az egyik partner eltávolításával

    A rekord törölve:The record is deleted:

    Törölt rekord

  12. Az alkalmazás előzetes verziójának lezárása.Close the app preview.