Share via


Funktsioonid Remove ja RemoveIf

Kehtib: Lõuendirakendused Mudelipõhised rakendused Power Platform CLI

Eemaldab kirjedandmeallikast.

Märkus.

PAC CLI pac power-fx käsud ei toeta funktsiooni RemoveIF.

Kirjeldus

Eemaldamisfunktsioon

Kasutage Remove funktsiooni, et eemaldada kindel kirje või kindlad kirjed andmeallikast.

Kollektsioonide puhul peab kogu kirje ühtima. Saate kasutada argumenti RemoveFlags.All , et eemaldada kirjest kõik koopiad; vastasel juhul eemaldatakse kirjest ainult üks eksemplar.

Removelfi funktsioon

Funktsiooniga RemoveIf saate eemaldada kirje või kirjed tingimuse või tingimuste kogumi põhjal. Iga tingimus võib olla mis tahes valem, mille tulemuseks on tõene või väär, ja mis võib viidata andmeallika veergudele nime järgi. Igat tingimust hinnatakse iga kirje jaoks eraldi ja kirje eemaldatakse, kui kõik tingimused on tõesed.

Eemalda ja RemoveIf tagastavad muudetud andmeallika tabelina. Mõlemat funktsiooni saate kasutada ainult käitumise valemites.

Funktsiooniga Tühjenda saate eemaldada kõik kollektsiooni kirjed.

Delegeerimine

Kui neid funktsioone kasutatakse koos andmeallikas, ei saa neid delegeerida. Tuuakse ainult andmeallika esimene osa ja seejärel rakendatakse funktsioon. See ei pruugi esindada kogu lugu. Loomise ajal võidakse kuvada hoiatus, mis tuletab teile seda piirangut meelde.

Delegatsioonide toetus (eksperimentaalne)

RemoveIfi delegeerimise tugi on nüüd seda toetavate andmeallikate eksperimentaalses eelvaates (vaikimisi VÄLJAS). Kui andmeallikas seda funktsiooni ei toeta, saadab see serverisse päringu ja toob kõik andmed, mis vastavad filtriavaldisele kuni maksimaalse 500, Power Apps 2000 või andmelehe suuruseni. Seejärel teostab see kõigi nende kirjete kustutamistoimingu koos individuaalsete kõnedega serverile.

Süntaks

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

  • DataSource – Nõutav. Andmeallikas, mis sisaldab kirjet või kirjeid, mida soovite eemaldada.
  • Kirje(d) – Nõutav. Kirje või kirjed, mida soovite eemaldada.
  • RemoveFlags.All – valikuline. Kogumis võib sama kirjet kuvada mitu korda. Saate lisada argumendi RemoveFlags.All , et eemaldada kirje kõik koopiad.

Remove( DataSource; Table [, RemoveFlags.All ] )

  • DataSource – Nõutav. Andmeallikas, mis sisaldab kirjeid, mida soovite eemaldada.
  • Tabel – Nõutav. Eemaldatavate kirjete tabel.
  • RemoveFlags.All – valikuline. Kogumis võib sama kirjet kuvada mitu korda. Saate lisada argumendi RemoveFlags.All , et eemaldada kirje kõik koopiad.

RemoveIf( Andmeallikas, Tingimus [, ... ] )

  • DataSource – Nõutav. Andmeallikas, mis sisaldab kirjet või kirjeid, mida soovite eemaldada.
  • Tingimus(ed) – Nõutav. Valem, mis arvutatakse kirje või kirjete eemaldamiseks tõesena. Saate kasutada rakenduse andmeallikas olevaid veergude nimesid. Kui määrate mitu tingimust, peavad kõik kirje või kirjete eemaldamisel olema märgitud kui tõesed.

Näited – üksikud valemid

Nendes näidetes eemaldate kirje või kirjed andmeallikas, mille nimi on jäätis ja mis algab selle tabeli andmetega.

IceCream näide.

Kollektsiooni loomine koos näidiskirjetega

Andmete kogumi loomiseks toimige järgmiselt.

  1. Sisestage Nupu juhtelement.

  2. Seadke nupu juhtelemendi atribuut OnSelect väärtus järgmisele valemile.

    ClearCollect( IceCream,
                  { ID: 1, Flavor: "Chocolate",  Quantity: 100 },
                  { ID: 2, Flavor: "Vanilla",    Quantity: 200 },
                  { ID: 3, Flavor: "Strawberry", Quantity: 300 }
    )
    
  3. Valige nupp, hoides all klahvi Alt.

Näidiskirjete eemaldamine kogumikust valemi abil

Valem Kirjeldus Tulemus
Eemalda( Jäätis,
LookUp( Jäätis, Flavor="Šokolaad" ))
Eemaldab andmeallikast šokolaadi kirje. Tulemus vanilli ja maasikaga.

Andmeallikat IceCream on muudetud.
Eemalda( Jäätis,
LookUp( IceCream, Flavor="Chocolate" ), LookUp( IceCream, Flavor="Strawberry" ) )
Eemaldab kaks kirjet andmeallikast. Tulemus ainult vanilliga.

Andmeallikat IceCream on muudetud.
RemoveIf( Jäätis, kogus > 150 ) Eemaldab kirjed, mille kogus on suurem kui 150. Tulemus ainult šokolaadiga.

Andmeallikat IceCream on muudetud.
RemoveIf( Jäätis, kogus > 150, vasak( maitse, 1 ) = "S" ) Eemaldab kirjed, mille kogus on suurem kui 150 ja maitse algab S-tähega. Tulemus šokolaadi ja vanilliga.


Andmeallikat IceCream on muudetud.
RemoveIf( Jäätis, tõene ) Eemaldab kõik kirjed andmeallikast. Tulemus ilma IceCream’ita.

Andmeallikat IceCream on muudetud.

Selles näites saate kasutada Galerii juhtelementi, et loetleda tabeli kirjeid. Seejärel kasutage funktsiooni Remove, et üksust valikuliselt eemaldada.

Näidisandmete ettevalmistamine

Selles näites kasutatakse Kontaktid saadaolevat tabelit Microsoft Dataverseis koos näidisrakenduste ja andmetega. Keskkonna loomisel saate juurutada näidisrakendusi ja andmeid. Selle asemel saate kasutada ka muid andmeallikaid.

Selles näites eemaldate üksuse, kasutades nuppu, mis asub väljaspool galeriid.

  1. Saate luua telefoni paigutuse abil uue tühja lõuendi rakenduse.

    Tühja lõuendi rakendus, kasutades telefoni paigutust.

  2. Valige vasakpoolsel paanil suvand Sisesta.

  3. Valige Vertikaalne galerii.
    Galerii juhtelement lisatakse ekraanile.

    Tööriistapaani Sisesta kasutamine vertikaalse galerii juhtelemendi lisamiseks.

  4. Teil palutakse valida andmeallikas, kus saate valida saadaolevate andmeallikate hulgast andmeallika.
    Valige näiteks Kontaktid tabel, et kasutada näidisandmeid.

    Galeriis kuvatavate kontaktide tabeli valimine.

    Galeriis kuvatakse selle tabeli üksused:

    Lisatud galerii, kus on kuvatud kontaktide tabel.

  5. Lisage nupu juhtelement vasakpoolsel paanil.

    Tööriistapaani Sisesta kasutamine nupu juhtelemendi lisamiseks.

  6. Teisaldage lisatud nupp galerii üksuste alla.

    Nupp Teisalda.

  7. Kirje eemaldamiseks värskendage nupu teksti atribuuti. Saate kasutada ka enda valitud teksti.

    Nupp Nimeta ümber.

  8. Määrake selle nupu juhtelemendi atribuudi OnSelect väärtus järgmisele valemile.

    Remove( Contacts, Gallery1.Selected )
    

    Nupu juhtelemendi atribuudi OnSelect määramine.

    Galerii juhtelement muudab valitud atribuudi abil praegu valitud kirje kättesaadavaks. Remove funktsioon viitab sellele valitud kirjele, et see eemaldada.

  9. Vaadake rakenduse eelvaadet üleval paremal oleva nupu Esita abil või vajutage klaviatuuril klahvi F5.

    Eelvaaterakendus.

  10. Valige eemaldatav kirje (nt Nancykirje selles näites).

    Valige kirje.

  11. Valige Eemalda kirje:

    Kontaktide galerii, nüüd ilma Nancy kirjeta, mis on eemaldatud.

    Nupu valimisel eemaldatakse valitud kirje (selles näites Nancy kirje).

  12. Sulgege rakenduse eelvaade.

    Jootraha

    Saate kasutada ka alternatiivset käitumist klahviga Alt, selle asemel, et kasutada rakenduse eelvaadet nupuga Esita või klahviga F5.

Selles näites eemaldate üksuse, kasutades ikooni, mis asub galeriis.

Kollektsiooni loomine koos näidisandmetega

Kui teil juba on ettevalmistatud näidisandmed, jätke see etapp vahele ja teisaldage prügikasti ikoonile galeriis.

  1. Lisage ekraanile nupu juhtelement.

  2. Määrake atribuut OnSelect järgmisele valemile.

    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. Valige nupp, hoides all klahvi Alt.

Luuakse näidiskogum, mida saab kasutada järgmises näites.

  1. Saate luua telefoni paigutuse abil uue tühja lõuendi rakenduse.

    Tühja lõuendi rakendus, kasutades telefoni paigutust.

  2. Valige vasakpoolsel paanil suvand Sisesta.

  3. Valige Vertikaalne galerii.
    Galerii juhtelement lisatakse ekraanile.

    Tööriistapaani Sisesta kasutamine vertikaalse galerii juhtelemendi lisamiseks.

  4. Teil palutakse valida andmeallikas, kus saate valida saadaolevate andmeallikate hulgast andmeallika.
    Valige näiteks Kontaktid tabel, et kasutada näidisandmeid.

    Galeriis kuvatavate kontaktide tabeli valimine.

    Kui lõite kogumi, valige selle asemel oma kogum.

    Näidiskontaktide kogum.

  5. Valige galerii ülemisest üksusest juhtelement.

    Tagamaks, et järgmine etapp lisab üksuse galerii malli ja mitte väljapoole galeriid, veenduge, et järgiksite seda etappi enne järgmise etapi juurde asumist.

    Valige galeriis ülemine kirje.

  6. Valige vasakult paanilt Lisa ikoon.

    Tööriistapaani Sisesta kasutamine ikooni juhtelemendi lisamiseks.

    Märkus.

    Lisa ikoon lisab galerii vasakusse äärde ikooni +, mis on kopeeritud iga galeriiüksuse jaoks.

  7. Teisaldage ülemises üksuses ikoon ekraani parempoolsesse serva.

    Teisalda ikoon.

  8. Valige ikooni atribuut ja määrake see järgmisele valemile, et muuta ikooni pilt prügikasti ikooniks.

    Icon.Trash
    

    Märkus.

    Eesliide Ikoon. kuvatakse ainult siis, kui muudate aktiivselt valemit.

    Ikooni muutmine prügikasti ikooniks.

  9. Määrake atribuut OnSelect järgmisele valemile.

    Remove( [@Contacts], ThisItem )
    

    Märkus.

    Peate kasutama globaalset täpsustuse tehtemärki[@...] selles näites näidisandmetega Kontaktid tabelis, et vältida konfikti üks-mitmele seosega. Kui kasutate andmeallikaid (nt loendit või SQL Serveri tabelit), pole globaalset täpsustuse tehtemärki kasutamine vajalik.

    OnSelect prügikasti ikoonile.

  10. Vaadake rakenduse eelvaadet üleval paremal oleva nupu Esita abil või vajutage klaviatuuril klahvi F5.

  11. Valige kirje kõrval prügikasti ikoon, näiteks Maria.

    Galerii, kus üks kontakt on eemaldatud.

    Kirje on kustutatud:

    Kustutatud kirje.

  12. Sulgege rakenduse eelvaade.