Alih keluar dan alih keluar fungsi

Artikel
03/22/2024

Digunakan untuk: Aplikasi kanvas Apl Power Platform berpandukan model CLI

Nota

PAC CLI pac power-fx commands tidak menyokong fungsi RemoveIF .

Description

Fungsi alih keluar

Gunakan fungsi Remove untuk mengeluarkan rekod tertentu atau rekod daripada sumber data.

Untuk koleksi, kesemua rekod mesti sepadan. Anda boleh menggunakan argumen RemoveFlags.All untuk mengalih keluar semua salinan rekod; jika tidak, hanya satu salinan rekod dialih keluar.

Fungsi RemoveIf

Gunakan fungsi RemoveIf untuk mengalih keluar rekod atau rekod berasaskan pada syarat atau set syarat. Setiap syarat boleh menjadi mana-mana hasil dalam benar atau palsu dan boleh merujuk lajur bagi sumber data mengikut nama. Setiap syarat dinilai secara individu untuk setiap rekod, dan rekod dialih keluar jika semua syarat dinilai sebagai benar.

Alih Keluar dan RemoveIf mengembalikan sumber data yang diubah suai sebagai jadual. Anda juga boleh menggunakan kedua-dua fungsi hanya dalam formula tingkah laku.

Anda juga boleh menggunakan fungsi Clear untuk mengalih keluar semua rekod dalam koleksi.

Perwakilan

Apabila digunakan dengan sumber data, fungsi ini tidak boleh diwakilkan. Bahagian pertama sumber data sahaja yang akan diambil, kemudian fungsi ini digunakan. Ini mungkin tidak mewakili cerita lengkap. Amaran mungkin muncul pada masa pengarangan untuk mengingatkan anda tentang batasan ini.

Sokongan perwakilan (Eksperimen)

Sokongan perwakilan untuk RemoveIf kini dalam Pratonton Eksperimen (default OFF) untuk sumber data yang menyokongnya. Jika sumber data tidak menyokong ciri ini, akan menghantar pertanyaan kepada pelayan dan mengambil semua data yang sepadan dengan ungkapan penapis sehingga maksimum 500, Power Apps 2000 atau saiz halaman data. Kemudian, ia akan melakukan operasi padam pada setiap rekod tersebut dengan panggilan individu ke pelayan.

Sintaks

Alih keluar( DataSource,Record1[,Record2 , ... ] [, RemoveFlags.All ] )

DataSource – Diperlukan. Sumber data yang mengandungi rekod atau rekod yang anda mahu alih keluar.
Rekod – Diperlukan. Rekod untuk dialih keluar.
RemoveFlags.All – Pilihan. Dalam pengumpulan, rekod yang sama mungkin dipaparkan lebih daripada sekali. Anda boleh menambah argumen RemoveFlags.All untuk mengalih keluar semua salinan rekod.

Alih keluar( DataSource,Jadual[,RemoveFlags.All ] )

DataSource – Diperlukan. Sumber data yang mengandungi rekod yang anda mahu alih keluar.
Jadual – Diperlukan. Jadual rekod yang dialih keluar.
RemoveFlags.All – Pilihan. Dalam pengumpulan, rekod yang sama mungkin dipaparkan lebih daripada sekali. Anda boleh menambah argumen RemoveFlags.All untuk mengalih keluar semua salinan rekod.

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

DataSource – Diperlukan. Sumber data yang mengandungi rekod atau rekod yang anda mahu alih keluar.
Syarat – Diperlukan. Formula yang menilai benar untuk rekod yang dialih keluar. Anda boleh menggunakan nama lajur daripada DataSource dalam formula. Jika anda tentukan berbilang Syarat, semua mesti dinilai benar untuk rekod yang akan dialih keluar.

Contoh - formula tunggal

Dalam contoh ini, anda akan mengalih keluar rekod dalam sumber data bernama IceCream dan yang bermula dengan data dalam jadual ini:

Contoh Aiskrim.

Cipta koleksi dengan rekod sampel

Untuk mencipta koleksi dengan data ini:

Sisipkan kawalan Butang.

Tetapkan sifat kawalan butang OnSelect ke formula di bawah:

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

Pilih butang semasa menekan kunci Alt:

Alih keluar rekod sampel daripada koleksi menggunakan formula

Formula	Description	Keputusan
Alih keluar( IceCream, LookUp( IceCream, Rasa = "Coklat" ))	Alih keluar rekod Coklat daripada sumber data.	Sumber data IceCream telah diubah suai.
Alih keluar( IceCream, LookUp( IceCream, Rasa = "Coklat" ), LookUp ( IceCream, Rasa = "Strawberi" ) ) )	Alih keluar dua rekod daripada sumber data.	Sumber data IceCream telah diubah suai.
RemoveIf( IceCream, Kuantiti > 150 )	Alih keluar rekod yang mempunyai Kuantiti yang lebih besar daripada 150.	Sumber data IceCream telah diubah suai.
RemoveIf( IceCream, Kuantiti > 150, Kiri( Perisa, 1 ) = "S" )	Alih keluar rekod yang mempunyai Kuantiti yang lebih besar daripada 150 dan Perisa bermula daripada S.	Sumber data IceCream telah diubah suai.
RemoveIf( IceCream, benar )	Alih keluar semua rekod daripada sumber data.	Sumber data IceCream telah diubah suai.

Contoh - alih keluar butang di luar galeri

Dalam contoh ini, anda akan menggunakan kawalan Galeri untuk menyenaraikan rekod dalam jadual. Dan kemudian gunakan fungsi Remove untuk mengalih keluar item secara selektif.

Menyediakan data sampel

Contoh ini menggunakan jadual Kenalan dalam Microsoft Dataverse tersedia dengan aplikasi dan data sampel. Anda boleh menggunakan aplikasi dan data sampel apabila anda mencipta persekitaran. Sebaliknya anda juga boleh menggunakan mana-mana sumber data.

Alih keluar butang di luar galeri

Dalam contoh ini, anda akan mengalih keluar item dengan menggunakan butang yang berada di luar galeri.

Cipta aplikasi kanvas kosong yang baharu menggunakan tataletak Telefon.
Pilih Sisipkan daripada anak tetingkap sebelah kiri.
Pilih Galeri menegak.
Kawalan Galeri ditambah pada skrin anda.
Anda digesa untuk memilih sumber data di mana anda boleh memilih sumber data daripada sumber data yang tersedia.
Contohnya, pilih jadual Kenalan untuk menggunakan data sampel:

Galeri menunjukkan item daripada jadual ini:
Sisipkan kawalan Butang daripada anak tetingkap sebelah kiri:
Gerakkan butang ditambah di bawah item galeri:
Kemas kini sifat teks butang ke Alih keluar rekod. Anda juga boleh menggunakan teks pilihan anda:
Tetapkan sifat OnSelect untuk kawalan butang ini ke formula berikut:
```
Remove( Contacts, Gallery1.Selected )
```
Kawalan galeri membuatkan rekod yang dipilih pada masa ini tersedia menggunakan sifat Dipilih. Fungsi Alih keluar merujuk kepada rekod yang dipilih ini untuk mengalihnya keluar.
Pratonton aplikasi menggunakan butang Main pada sebelah atas kanan, atau tekan F5 pada papan kekunci:
Pilih rekod untuk dialih keluar, seperti rekod Nancy dalam contoh ini:
Pilih Alih keluar rekod:

Memilih butang mengalih keluar rekod yang dipilih (dalam contoh ini, rekod Nancy).
Tutup pratonton aplikasi.

Tip

Anda juga boleh menggunakan tingkah laku alternatif dengan Kunci Alt daripada menggunakan pratonton aplikasi dengan butang Main atau F5.

Contoh - ikon tong sampah di dalam galeri

Dalam contoh ini, anda akan mengalih keluar item menggunakan ikon yang diletakkan di dalam galeri.

Cipta koleksi dengan data sampel

Jika anda telah mempunyai data sampel yang disediakan, langkau langkah ini dan beralih ke Ikon tong sampah di dalam galeri.

Tambah kawalan Butang ke skrin anda.

Tetapkan sifat OnSelect ke formula berikut:

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

Pilih butang semasa menekan kunci Alt.

Koleksi sampel dicipta supaya anda boleh menggunakannya dalam contoh berikut.

Ikon tong sampah di dalam galeri

Cipta aplikasi kanvas kosong yang baharu menggunakan tataletak Telefon.
Pilih Sisipkan daripada anak tetingkap sebelah kiri.
Pilih Galeri menegak.
Kawalan Galeri ditambah pada skrin anda.
Anda digesa untuk memilih sumber data di mana anda boleh memilih sumber data daripada sumber data yang tersedia.
Contohnya, pilih jadual Kenalan untuk menggunakan data sampel:

Jika anda mencipta koleksi, sebaliknya pilih koleksi anda:
Pilih kawalan dalam item teratas dalam galeri .

Untuk memastikan langkah seterusnya masukkan item ke dalam templat galeri dan bukan di luar galeri, pastikan anda mengikuti langkah ini sebelum bergerak ke langkah seterusnya.
Pilih Tambah ikon daripada anak tetingkap sebelah kiri.

Nota

Tambah ikon sisipkan + ikon pada sebelah kiri galeri, direplikasi untuk setiap item dalam galeri.
Pada item teratas, gerakkan ikon ke sebelah kanan skrin.
Pilih sifat Ikon untuk ikon dan tetapkannya ke formula berikut untuk mengemas kini imej ikon sebagai ikon sampah:
```
Icon.Trash
```
Nota

Awalan Ikon. hanya ditunjukkan apabila anda mengedit formula dengan aktif.
Tetapkan sifat OnSelect ke formula berikut:
```
Remove( [@Contacts], ThisItem )
```
Nota

Anda mesti menggunakan operator penyahtaksaan global[@...] dalam contoh ini dengan data sampel yang menggunakan jadual Kenalan untuk mengelakkan konflik dengan hubungan Satu ke Banyak. Jika anda menggunakan sumber data seperti senarai atau jadual Pelayan SQL, penggunaan operator penyahtaksaan global tidak diperlukan.
Pratonton aplikasi menggunakan butang Main pada sebelah atas kanan, atau tekan F5 pada papan kekunci.
Pilih ikon sampah berhampiran rekod, contohnya Maria:

Rekod dipadam:
Tutup pratonton aplikasi.