Fungsi DataSourceInfo
Digunakan untuk:
Aplikasi kanvas Aplikasi dipacu model
Memberi maklumat tentang sumber data.
Gambaran keseluruhan
Sumber data boleh memberikan banyak maklumat untuk mengoptimumkan pengalaman pengguna.
Anda boleh menggunakan lajur-maklumat tahap untuk mengesahkan input pengguna dan memberikan maklum balas segera kepada pengguna sebelum menggunakan fungsi Patch. Fungsi Validate menggunakan maklumat yang sama ini.
Anda boleh menggunakan maklumat pada peringkat sumber data, misalnya, untuk menyahdayakan atau menyembunyikan butang Edit dan Baharu untuk pengguna yang tidak mempunyai kebenaran untuk mengedit dan mencipta rekod.
Sumber data berbeza dalam seberapa banyak maklumat yang mereka berikan termasuk tidak memberikan sama sekali. Koleksi tidak memberikan maklumat. Jika sebilangan maklumat tidak diberikan, lalai digunakan atau kosong dikembalikan.
Nota
Pada masa ini, fungsi DataSourceInfo tidak disokong dalam Microsoft Senarai.
Description
Maklumat lajur
Anda boleh menggunakan DataSourceInfo untuk mendapatkan maklumat tentang lajur tertentu sumber data:
| Argumen Maklumat | Jenis Hasil | Penerangan |
|---|---|---|
| DataSourceInfo.DisplayName | Jalur | Nama paparan untuk lajur. Jika tiada nama paparan ditakrifkan akan mengembalikan nama lajur. |
| DataSourceInfo.MaxLength | Nombor | Bilangan maksimum aksara yang lajur boleh menahan. Digunakan hanya pada lajur yang mengandungi rentetan. Jika maksimum tidak ditetapkan, kembalikan kosong. |
| DataSourceInfo.MaxValue | Nombor | Nilai angka maksimum yang lajur boleh menahan. Digunakan hanya pada lajur yang mengandungi nombor. Jika maksimum tidak ditetapkan, kembalikan kosong. |
| DataSourceInfo.MinValue | Nombor | Nilai angka minimum yang lajur boleh menahan. Digunakan hanya pada lajur yang mengandungi nombor. Jika minimum tidak ditetapkan, kembalikan kosong. |
| DataSourceInfo.Diperlukan | Boolean | Adakah nilai diperlukan untuk lajur ini? Jika tidak ditetapkan oleh sumber data, kembalikan palsu. |
Argumen ketiga ialah nama lajur sebagai rentetan. Sebagai contoh, lajur Telefon dalam koleksi Individu akan diluluskan sebagai "Telefon" termasuk petikan berganda.
Maklumat sumber data
Anda juga boleh menggunakan DataSourceInfo untuk mendapatkan maklumat tentang sumber data secara keseluruhan:
| Argumen Maklumat | Jenis Hasil | Penerangan |
|---|---|---|
| DataSourceInfo.AllowedValues | Boolean | Apakah jenis keizinan yang boleh pengguna berikan untuk sumber data ini? Jika tidak ditetapkan oleh sumber data, kembalikan kosong. |
| DataSourceInfo.CreatePermission | Boolean | Adakah pengguna semasa mempunyai keizinan untuk mencipta rekod dalam sumber data ini? Jika tidak ditetapkan oleh sumber data, kembalikan benar. |
| DataSourceInfo.DeletePermission | Boolean | Adakah pengguna semasa mempunyai keizinan untuk memadam rekod dalam sumber data ini? Jika tidak ditetapkan oleh sumber data, kembalikan benar. |
| DataSourceInfo.EditPermission | Boolean | Adakah pengguna semasa mempunyai keizinan untuk mengedit rekod dalam sumber data ini? Jika tidak ditetapkan oleh sumber data, kembalikan benar. |
| DataSourceInfo.ReadPermission | Boolean | Adakah pengguna semasa mempunyai keizinan untuk membaca rekod dalam sumber data ini? Jika tidak ditetapkan oleh sumber data, kembalikan benar. |
Nota
DataSourceInfo mengembalikan benar jika ia tidak dapat menentukan sama ada pengguna semasa mempunyai keizinan yang diminta. Keizinan akan disemak semula oleh pelayan apabila operasi sebenar dijalankan dan ralat dipaparkan jika ia tidak dibenarkan. Pada masa ini, keizinan yang menyemak dengan DataSourceInfo hanya berkemungkinan apabila menggunakan Microsoft Dataverse.
Sintaks
DataSourceInfo ( Sumber Data,Maklumat [, Nama Lajur] )
- Sumber Data– Diperlukan. Sumber data yang akan digunakan.
- Maklumat - Diperlukan. Jenis maklumat yang anda ingin dapat kembali.
- ColumnName – Pilihan. Nama lajur yang mana untuk mendapatkan maklumat peringkat lajur. Untuk maklumat di peringkat sumber data, argumen ColumnName tidak boleh digunakan.
Nota
Sebelum Power Apps versi 3.24042, nama lajur telah ditentukan dengan rentetan teks menggunakan petikan berganda, dan jika disambungkan ke sumber data ia juga perlu menjadi nama logik. Sebagai contoh, nama logik"cr43e_name"dengan petikan berganda telah digunakan dan bukannya nama paparan Nama tanpa petikan. Untuk dan SharePoint sumber data Excel yang mengandungi nama lajur dengan ruang, setiap ruang telah ditentukan dengan "_x0020_", contohnya "Nama Lajur"sebagai "Column_x0020_Name". Selepas versi ini, semua app dikemas kini secara automatik kepada sintaks baharu yang diterangkan dalam artikel ini.
Contoh
Contoh dalam bahagian ini menggunakan sumber data ini yang dinamakan Ais Krim:
Sumber data juga memberikan maklumat ini:
- Nama paparan untuk Kuantiti adalah "Kuantiti dalam Tangan".
- Panjang maksimum Perisa adalah 30 aksara.
- Lajur Perisa mesti mengandungi nilai. Lajur Kuantiti tidak diperlukan.
- Kuantiti minimum adalah 0.
- Kuantiti maksimum adalah 100.
- Pengguna semasa boleh membaca dan mengedit rekod sumber data Ais Krim tetapi tidak boleh mencipta atau memadam rekod.
| Formula | Penerangan | Hasil |
|---|---|---|
| DataSourceInfo ( IceCream, DataSourceInfo.DisplayName, Kuantiti ) | Mengembalikan nama paparan untuk lajur Kuantiti bagi sumber data Ais Krim. | "Kuantiti dalam Tangan" |
| DataSourceInfo ( Ais Krim, DataSourceInfo.MaxLength, Flavor ) | Mengembalikan panjang maksimum rentetan untuk lajur Perisa bagi sumber data Ais Krim. | 30 |
| DataSourceInfo ( Ais Krim, DataSourceInfo.Diperlukan, Rasa ) | Adakah lajur Perisa bagi sumber data Ais Krim diperlukan? | Benar |
| DataSourceInfo ( IceCream, DataSourceInfo.Required, Kuantiti ) | Adakah lajur Kuantiti bagi sumber data Ais Krim diperlukan? | Palsu |
| DataSourceInfo ( Ais Krim, DataSourceInfo.MaxValue, Kuantiti ) | Mengembalikan nilai angka maksimum untuk lajur Kuantiti bagi sumber data Ais Krim. | 100 |
| DataSourceInfo ( IceCream, DataSourceInfo.MinValue, Kuantiti ) | Mengembalikan nilai angka minimum untuk lajur Kuantiti bagi sumber data Ais Krim. | 0 |
| DataSourceInfo ( Ais Krim, DataSourceInfo.ReadPermission) | Bolehkah pengguna semasa membaca rekod dalam sumber data Ais Krim? | Benar |
| DataSourceInfo ( Ais Krim, DataSourceInfo.EditPermission) | Bolehkah pengguna semasa mengedit rekod dalam sumber data Ais Krim? | Benar |
| DataSourceInfo ( IceCream, DataSourceInfo.CreatePermission) | Bolehkah pengguna semasa mencipta rekod dalam sumber data Ais Krim? | Palsu |
| DataSourceInfo ( IceCream, DataSourceInfo.DeletePermission) | Bolehkah pengguna semasa memadam rekod dalam sumber data Ais Krim? | Palsu |