Kongsi melalui


Fungsi DataSourceInfo

Digunakan pada: Aplikasi kanvas Apl berpandukan 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 Senarai Microsoft.

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.Required 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 menjadi benar jika ia tidak boleh 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( DataSource,Information [, ColumnName] )

  • DataSource – Diperlukan. Sumber data yang akan digunakan.
  • Maklumat – Diperlukan. Jenis maklumat yang anda ingin dapat kembali.
  • ColumnName – Pilihan. Nama lajur 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 ditentukan dengan rentetan teks menggunakan petikan berganda dan jika disambungkan ke sumber data ia juga perlu nama logik. Sebagai contoh, nama logik"cr43e_name" dengan petikan berganda digunakan dan bukannya nama paparan Nama tanpa petikan. Untuk SharePoint dan sumber data Excel yang mengandungi nama lajur dengan ruang, setiap ruang ditentukan dengan "_x0020_", contohnya "Nama Lajur" sebagai "Column_x0020_Name". Selepas versi ini, semua apl telah 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:

Contoh aiskrim.

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( IceCream, DataSourceInfo.MaxLength, Rasa ) Mengembalikan panjang maksimum rentetan untuk lajur Perisa bagi sumber data Ais Krim. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor ) Adakah lajur Perisa bagi sumber data Ais Krim diperlukan? benar
DataSourceInfo( IceCream, DataSourceInfo.Required, Kuantiti ) Adakah lajur Kuantiti bagi sumber data Ais Krim diperlukan? benar
DataSourceInfo( IceCream, 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( Ais Krim, DataSourceInfo.CreatePermission) Bolehkah pengguna semasa mencipta rekod dalam sumber data Ais Krim? palsu
DataSourceInfo( Ais Krim, DataSourceInfo.DeletePermission) Bolehkah pengguna semasa memadam rekod dalam sumber data Ais Krim? palsu