Remove және RemoveIf функциялары

Мақала
11/05/2024

Қолданылады: Canvas қолданбалары Үлгіге негізделген қолданбалар Power Platform CLI

Ескертпе

PAC CLI pac power-fx пәрмендері RemoveIf функциясына қолдау көрсетпейді.

Сипаттама

Remove функциясы

Remove функциясын деректер көзінен белгілі бір жазбаны немесе жазбаларды жою үшін пайдаланыңыз.

Жинақтар үшін бүкіл жазба сәйкес болуы керек. Жазбаның барлық көшірмелерін жою үшін RemoveFlags.All аргументін пайдалануға болады; әйтпесе жазбаның бір ғана көшірмесі жойылады.

RemoveIf функциясы

RemoveIf функциясын жазбаны немесе жазбаларды шарт немесе шарттар жиыны негізінде жою үшін пайдаланыңыз. Әр шарт true немесе false мәніне әкелетін кез келген формула болуы мүмкін және деректер көзінің бағандарына атауы бойынша сілтеме жасауы мүмкін. Әр шарт әр жазба үшін жеке есептеледі және барлық шарттар есептегеннен кейін true мәнін қайтарса, жазба жойылады.

Жою және RemoveIf өзгертілген деректер көзі файлын кесте ретінде қайтарыңыз. Функциялардың екеуін де тек мінез-құлық формулаларында пайдалануға болады.

Сондай-ақ жинақтағы барлық жазбаларды жою үшін Clear функциясын пайдалануға болады.

Өкіл

RemoveIf қолданбасына бірнеше деректер көздері ғана қолдау көрсетеді. Бұл мүмкіндікті қолдамайтын деректер көздері үшін Power Apps серверді сұрайды және сүзгі өрнегімен сәйкес келетін барлық деректерді, ең көбі 500 немесе 2000 жазбаға немесе деректер беті өлшеміне дейін шығарып алады. Кейіннен ол серверге жеке қоңыраулар жасау арқылы сол жазбалардың әрқайсысын жеке жояды.

Синтаксис

Жою( DataSource, Жазба1 [, Жазба2 , ... ] [, RemoveFlags.All ] )

Деректер көзі – Міндетті. Жойғыңыз келетін жазбаны немесе жазбаларды қамтитын деректер көзі.
Жазбалар – Міндетті. Жоятын жазба немесе жазбалар.
RemoveFlags.All – Қосымша. Жинақта бір жазба бірнеше рет көрінуі мүмкін. Жазбаның барлық көшірмелерін жою үшін RemoveFlags.All аргументін қосуға болады.

Жою( DataSource, Кесте [, Жалаушаларды жою .Барлығы ] )

Деректер көзі – Міндетті. Жойғыңыз келетін жазбаларды қамтитын деректер көзі.
Кесте – Міндетті. Жоятын жазбалар кестесі.
RemoveFlags.All – Қосымша. Жинақта бір жазба бірнеше рет көрінуі мүмкін. Жазбаның барлық көшірмелерін жою үшін RemoveFlags.All аргументін қосуға болады.

RemoveIf( Дереккөз, Шарт [, ... ] )

Деректер көзі – Міндетті. Жойғыңыз келетін жазбаны немесе жазбаларды қамтитын деректер көзі.
Шарттар – Міндетті. Жоятын жазба немесе жазбалар үшін есептегенде true мәнін қайтаратын формула. DataSource баған атауларын формулада пайдалануға болады. Бірнеше Шарттар көрсетсеңіз, жоятын жазба немесе жазбалар үшін барлығы есептегенде true мәнін қайтаруы керек.

Мысалдар - жалғыз формулалар

Бұл мысалдарда, сіз IceCream атты және мына кестедегі деректермен басталатын деректер көзіндегі жазбаны немесе жазбаларды жоясыз:

Icecream мысалы.

Үлгі жазбалар бар жинақты жасау

Осы деректері бар жинақты жасау үшін:

Түйме басқару элементін кірістіріңіз.

Түймешік басқару элементінің OnSelect сипатын төмендегі формулаға орнатыңыз:

ClearCollect( IceCream,
              { ID: 1, Flavor: "Chocolate",  Quantity: 100 },
              { ID: 2, Flavor: "Vanilla",    Quantity: 200 },
              { ID: 3, Flavor: "Strawberry", Quantity: 300 }
)

Alt пернесін басып тұрып, түймешікті таңдаңыз:

Формуланы пайдаланып жинақтан үлгі жазбаларды жою

Формула	Сипаттама	Нәтиже
Жою( балмұздақ, Іздеу( балмұздақ, дәм = "Шоколад"))	Деректер көзінен Chocolate жазбасын жояды.	IceCream деректер көзі өзгертілді.
Жою( балмұздақ, LookUp( IceCream, Flavor="Шоколад" ), LookUp( IceCream, Flavor="Құлпынай" ) )	Екі жазбаны деректер көзінен жояды.	IceCream деректер көзі өзгертілді.
RemoveIf( балмұздақ, саны > 150 )	Quantity мәні 150-ден үлкенірек жазбаларды жояды.	IceCream деректер көзі өзгертілді.
RemoveIf( балмұздақ, саны > 150, сол жақ( дәм, 1 ) = "S" )	Quantity мәні 150-ден үлкенірек және Flavor опциясы S деп басталатын жазбаларды жояды.	IceCream деректер көзі өзгертілді.
RemoveIf( балмұздақ, шын )	Барлық жазбаларды деректер көзінен жояды.	IceCream деректер көзі өзгертілді.

Мысалдар - галереядан тыс түймешікті жою

Бұл мысалда, сіз кестедегі жазбаларды тізу үшін Галерея басқару элементін пайдаланасыз. Содан кейін элементті таңдау бойынша жою үшін Remove функциясын пайдаланыңыз.

Үлгі деректерді дайындау

Бұл мысалда үлгі бағдарламалармен және деректермен Microsoft Dataverse жүйесінде қолжетімді Контактілер кестесін пайдаланады. Үлгі бағдарламалар мен деректерді ортаны жасағанда орналастыруға болады. Сондай-ақ оның орнына кез келген басқа URL мекенжайын пайдалана аласыз.

Галереядан тыс түймешікті жою

Бұл мысалда, сіз галереядан тыс түймешікті пайдалана отырып элементті жоясыз.

"Телефон" орналасуын пайдаланып жаңа бос кенеп бағдарламасын жасаңыз.
Сол жақ тақтадан Кірістіру пәрменін таңдаңыз.
Тік галерея опциясын таңдаңыз.
Экраныңызға Галерея басқару элементі қосылады.
Сізден деректер көзін таңдау сұралады, ұмнда сіз қолжетімді деректер көздерінен деректер көзін таңдай аласыз.
Мысалы, үлгі деректерін пайдалану үшін Контактілер кестесін таңдаңыз:

Галереяда осы кестедегі элементтері көрсетіледі:
Сол жақ тақтадан Түймешік басқару элементін кірістіріңіз:
Қосылған түймешікті галерея элементтерінің астына жылжытыңыз:
Түймешіктің мәтін сипатын Жазбаны жою деп жаңартыңыз. Сондай-ақ өзіңіз таңдаған мәтінді пайдалана аласыз:
Осы түймешік басқару элементі үшін OnSelect сипатын келесі формулаға орнатыңыз:
```
Remove( Contacts, Gallery1.Selected )
```
Галерея басқару элементі Таңдалған сипатын пайдаланып қазіргі уақытта таңдалған жазбаны қолжетімді етеді. Жою функциясы оны жою үшін осы таңдалған жазбаға қатысты.
Жоғарғы оң жақтағы Play түймешігін пайдаланып немесе пернетақтада F5 пернесін басып бағдарламаны алдын ала қараңыз:
Жоятын жазбаны таңдаңыз, мысалы, осы мысалда Нэнси жазбасын:
Жазбаны жою пәрменін таңдаңыз:

Түймешікті таңдау таңдалған жазбаны жояды (мысалы, "Нэнси" жазбасын).
Бағдарламаны алдын ала қарауды жабыңыз.

Шайпұл

Сондай-ақ Ойнату түймешігі немесе F5 арқылы бағдарламаны алдын ала қарауды пайдаланудың орнына Alt пернесі арқылы баламалы мінез-құлықты пайдалануға болады.

Мысалдар - галерея ішіндегі себет белгішесі

Бұл мысалда, сіз элементті галерея ішінде орналастырылған белгішені пайдалана отырып жоясыз.

Үлгі деректер бар жинақты жасау

Үлгі деректерді дайындап қойған болсаңыз, осы қадамды өткізіп жіберіңіз және галерея ішіндегі себет белгішесіне жылжыңыз.

Экраныңызға Түймешік басқару элементін қосыңыз.

OnSelect сипатын келесі формулаға орнатыңыз:

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" }
)

Alt пернесін басып тұрып түймешікті таңдаңыз.

Келесі мысалда пайдалануға болатын үлгі жинақ жасалады.

Галерея ішіндегі себет белгішесі

"Телефон" орналасуын пайдаланып жаңа бос кенеп бағдарламасын жасаңыз.
Сол жақ тақтадан Кірістіру пәрменін таңдаңыз.
Тік галерея опциясын таңдаңыз.
Экраныңызға Галерея басқару элементі қосылады.
Сізден деректер көзін таңдау сұралады, ұмнда сіз қолжетімді деректер көздерінен деректер көзін таңдай аласыз.
Мысалы, үлгі деректерін пайдалану үшін Контактілер кестесін таңдаңыз:

Жинақты жасасаңыз, оның орнына жинағыңызды таңдаңыз:
Галереядағы жоғарғы элемент ішіндегі басқару элементін таңдаңыз.

Келесі қадамның элементті галереядан тыс емес, галерея үлгісіне кірістіруін қамтамасыз ету үшін, келесі қадамға өтпей тұрып осы қадамды орындаңыз.
Сол жақ тақтадан Белгіше қосу пәрменін таңдаңыз.

Ескертпе

Қосу белгішесі галереяның сол жағындағы a + белгішесін кірістіреді, галереядағы әрбір элемент үшін қайталанады.
Жоғағы элементте белгішені экранның оң жағына жылжытыңыз.
Белгішенің Белгіше сипатын таңдаңыз және белгіше кескінін себет белгішесі ретінде жаңарту үшін келесі формулаға орнатыңыз:
```
Icon.Trash
```
Ескертпе

Icon. префиксі сіз формуланы белсенді түрде өңдеп жатқанда ғана көрсетіледі.
OnSelect сипатын келесі формулаға орнатыңыз:
```
Remove( [@Contacts], ThisItem )
```
Ескертпе

Біреуі көпке қатынасымен қайшылықты болдырмау үшін осы мысалдағы глобалдық ажырату операторын[@...] Контактілер кестесін пайдаланатын үлгі деректермен пайдалану керек. Тізім немесе SQL сервер кестесі сияқты деректер көздерін пайдалансаңыз, жаһандық мәнді ажырату операторын пайдалану қажет емес.
Жоғарғы оң жақтағы Play түймешігін пайдаланып немесе пернетақтада F5 пернесін басып бағдарламаны алдын ала қараңыз.
Жазба, мысалы, Мария жазбасының жанындағы себет белгішесін таңдаңыз:

Жазба жойылды:
Бағдарламаны алдын ала қарауды жабыңыз.