DataSourceInfo funkcija
Taikoma:
drobės programoms Modeliu pagrįstoms programoms
Pateikia informaciją apie duomenų šaltinį.
Apžvalga
Duomenų šaltiniuose gali būti gausu informacijos, kurią naudojant galima optimizuoti vartotojo aplinką.
Galite naudoti stulpelių lygio informaciją, kad patikrintumėte vartotojo įvestį ir jam iš karto pateiktumėte atsiliepimų, o tada naudoti funkciją Patch. Funkcija Validate naudoja tą pačią informaciją.
Informaciją duomenų šaltinio lygiu galite naudoti, pavyzdžiui, norėdami išjungti arba paslėpti mygtukus Redaguoti ir Naujas vartotojams, neturintiems teisių redaguoti ir kurti įrašus.
Duomenų šaltiniai skiriasi pagal tai, kiek juose yra informacijos; kai kuriuose iš jų informacijos gali visai nebūti. Kolekcijose nėra jokios informacijos. Jei informacijos nėra, naudojama numatytoji informacija arba pateikiama blank.
Pastaba.
Šiuo metu "DataSourceInfo" funkcija nepalaikoma Microsoft sąrašuose.
Aprašą
Stulpelio informacija
Naudodami DataSourceInfo, galite gauti informacijos apie konkretų duomenų šaltinio stulpelį:
| Argumentas Information | Rezultatų tipas | Aprašas |
|---|---|---|
| DataSourceInfo.DisplayName | Eilutė | Rodomas stulpelio pavadinimas. Jei rodomas pavadinimas neapibrėžtas, pateikia stulpelio pavadinimą. |
| DataSourceInfo.MaxLength | Numeris | Maksimalus simbolių, kurie gali būti stulpelyje, skaičius. Taikoma tik stulpeliams, kuriuose yra eilučių. Jei maksimumas nėra nustatytas, pateikiama blank. |
| DataSourceInfo.MaxValue | Numeris | Maksimali skaitinė reikšmė, kuri gali būti stulpelyje. Taikoma tik stulpeliams, kuriuose yra skaičių. Jei maksimumas nėra nustatytas, pateikiama blank. |
| DataSourceInfo.MinValue | Numeris | Minimali skaitinė reikšmė, kuri gali būti stulpelyje. Taikoma tik stulpeliams, kuriuose yra skaičių. Jei minimumas nėra nustatytas, pateikiama blank. |
| DataSourceInfo.Required | Bulio logika | Ar šiame stulpelyje reikia reikšmės? Jei duomenų šaltinis nenustatė, pateikiama false. |
Trečiasis argumentas yra stulpelio pavadinimas kaip eilutė. Pavyzdžiui, rinkinio Žmonės stulpelis Telefonas būtų perduodamas kaip "Telefonas", įskaitant dvigubąsias kabutes.
Duomenų šaltinio informacija
Naudodami DataSourceInfo, taip pat galite gauti informacijos apie visą duomenų šaltinį:
| Argumentas Information | Rezultatų tipas | Aprašas |
|---|---|---|
| DataSourceInfo.AllowedValues | Bulio logika | Kokių tipų teisės, skirtos šiam duomenų šaltiniui, gali būti suteikiamos vartotojams? Jei duomenų šaltinis nenustatė, pateikiama blank. |
| DataSourceInfo.CreatePermission | Bulio logika | Ar dabartinis vartotojas turi teisę kurti įrašus šiame duomenų šaltinyje? Jei duomenų šaltinis nenustatė, pateikiama true. |
| DataSourceInfo.DeletePermission | Bulio logika | Ar dabartinis vartotojas turi teisę naikinti įrašus šiame duomenų šaltinyje? Jei duomenų šaltinis nenustatė, pateikiama true. |
| DataSourceInfo.EditPermission | Bulio logika | Ar dabartinis vartotojas turi teisę redaguoti įrašus šiame duomenų šaltinyje? Jei duomenų šaltinis nenustatė, pateikiama true. |
| DataSourceInfo.ReadPermission | Bulio logika | Ar dabartinis vartotojas turi teisę skaityti įrašus šiame duomenų šaltinyje? Jei duomenų šaltinis nenustatė, pateikiama true. |
Pastaba.
DataSourceInfo grąžina teisingą , jei negali nustatyti, ar dabartinis vartotojas turi prašomą leidimą. Kai bus atlikta tikroji operacija, serveris vėl patikrins teises ir, jei operacija buvo neleidžiama, bus rodoma klaida. Šiuo metu leidimų tikrinimas naudojant DataSourceInfo galimas tik naudojant „Microsoft Dataverse“.
Sintaksė
DataSourceInfo(DataSource,Information [, ColumnName ] )
- DataSource - būtina. Naudotinas duomenų šaltinis.
- Informacija – būtina. Informacijos, kurią norite gauti, tipas.
- ColumnName – pasirinktinai. Stulpelio, kurio stulpelio lygio informaciją reikia nuskaityti, pavadinimas. Jei informacija yra duomenų šaltinio lygio, argumento ColumnName naudoti negalima.
Pastaba.
Iki Power Apps 3.24042 versijos stulpelių pavadinimai buvo nurodyti teksto eilute, naudojant dvigubas kabutes, o jei jie buvo prijungti prie duomenų šaltinis jie taip pat turėjo būti loginiai pavadinimai. Pavyzdžiui, vietoj rodomo pavadinimo Vardas be kabučių buvo naudojamas loginis pavadinimas "cr43e_name" su dvigubomis kabutėmis. " SharePoint Excel" duomenų šaltiniuose, kuriuose yra stulpelių pavadinimai su tarpais, kiekvienas tarpas buvo nurodytas su "_x0020_", pvz., "Stulpelio pavadinimas" kaip"Column_x0020_Name". Po šios versijos visos programos buvo automatiškai atnaujintos į naują sintaksę, aprašytą šiame straipsnyje.
Pavyzdžiai
Šiame skyriuje pateiktuose pavyzdžiuose naudojamas duomenų šaltinis pavadinimu Ledai:
Duomenų šaltinis taip pat pateikė šią informaciją:
- Rodomas elemento Kiekis pavadinimas yra „Turimas kiekis“.
- Maksimalus elemento Skonis ilgis yra 30 simbolių.
- Stulpelyje Skonis turi būti reikšmė. Stulpelis Kiekis nėra būtinas.
- Minimalus Kiekis yra 0.
- Maksimalus Kiekis yra 100.
- Dabartinis vartotojas duomenų šaltinio Ledai įrašus gali skaityti ir redaguoti, tačiau negali kurti ar naikinti.
| Formulė | Aprašas | Rezultatas |
|---|---|---|
| DataSourceInfo( IceCream, DataSourceInfo.DisplayName, kiekis ) | Pateikia duomenų šaltinio Ledai stulpelio Kiekis rodomą pavadinimą. | „Turimas kiekis“ |
| DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Skonis ) | Pateikia maksimalų duomenų šaltinio Ledai stulpelio Skonis eilutės ilgį. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Skonis ) | Ar duomenų šaltinio Ledai stulpelis Skonis yra būtinas? | Tiesa |
| DataSourceInfo( IceCream, DataSourceInfo.Required, kiekis ) | Ar duomenų šaltinio Ledai stulpelis Kiekis yra būtinas? | klaidinga |
| DataSourceInfo( IceCream, DataSourceInfo.MaxValue, kiekis ) | Pateikia maksimalią skaitinę duomenų šaltinio Ledai stulpelio Kiekis reikšmę. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, kiekis ) | Pateikia minimalią skaitinę duomenų šaltinio Ledai stulpelio Kiekis reikšmę. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | Ar dabartinis vartotojas gali skaityti duomenų šaltinio Ledai įrašus? | Tiesa |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | Ar dabartinis vartotojas gali redaguoti duomenų šaltinio Ledai įrašus? | Tiesa |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | Ar dabartinis vartotojas gali kurti duomenų šaltinio Ledai įrašus? | klaidinga |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | Ar dabartinis vartotojas gali naikinti duomenų šaltinio Ledai įrašus? | klaidinga |