Funcția DataSourceInfo

Se aplică pentru: planșă de lucru apps Aplicații bazate pe model

Oferă informații despre sursă de date.

Prezentare generală

Sursele de date pot oferi o mulțime de informații pentru a optimiza experiența utilizatorului.

Puteți să folosiți informații de la nivelul coloanei pentru a valida intrarea utilizatorului și furnizați imediat feedback utilizatorului, înainte de utilizarea funcției Patch. Funcția Validate folosește aceeași informație.

Puteți utiliza informații la nivelul sursei de date, de exemplu, pentru a dezactiva sau a ascunde butoanele Editare și Nou pentru utilizatorii care nu au permisiuni pentru a edita și a crea înregistrări.

Sursele de date variază în funcție de volumul de informații pe care le furnizează, inclusiv faptul de a nu oferi deloc. Colecții nu furnizează informații. Dacă nu este furnizată o informație, se utilizează o valoare implicită sau este returnat necompletat.

Notă

În prezent, funcția DataSourceInfo nu este acceptată în Microsoft Lists.

Descriere

Informații despre coloană

Puteți să folosiți DataSourceInfo pentru a obține informații despre o anumită coloană a unei surse de date:

Argument informații	Tip rezultat	Descriere
DataSourceInfo.DisplayName	Șir de caractere	Nume afișat pentru coloană. Dacă nu este afișat niciun nume, returnează numele coloanei.
DataSourceInfo.MaxLength	Număr	Numărul maxim de caractere pe care îl poate conține coloana. Se aplică numai coloanelor care conțin șiruri. Dacă nu este setată o valoare maximă, returnează necompletat.
DataSourceInfo.MaxValue	Număr	Valoarea numerică maximă pe care o poate conține o coloană. Se aplică numai coloanelor care conțin numere. Dacă nu este setată o valoare maximă, returnează necompletat.
DataSourceInfo.MinValue	Număr	Valoarea numerică minimă pe care o poate conține o coloană. Se aplică numai coloanelor care conțin numere. Dacă nu este setată o valoare minimă, returnează necompletat.
DataSourceInfo.Required	Boolean	Este o valoare solicitată pentru această coloană? Dacă nu este setat de sursa de date, returnează fals.

Al treilea argument este numele unei coloane ca șir. De exemplu, coloana Telefon din colecția Persoane va fi transmis ca "Telefon", inclusiv ghilimelele duble.

Informații sursă de date

Puteți să folosiți de asemenea DataSourceInfo pentru a obține informații despre o sursă de date ca întreg:

Argument informații	Tip rezultat	Descriere
DataSourceInfo.AllowedValues	Boolean	Ce tipuri de permisiuni pot fi acordate utilizatorilor pentru această sursă de date? Dacă nu este setat de sursa de date, returnează necompletat.
DataSourceInfo.CreatePermission	Boolean	Are utilizatorul curent permisiunea de a crea înregistrări în această sursă de date? Dacă nu este setat de sursa de date, returnează necompletat.
DataSourceInfo.DeletePermission	Boolean	Are utilizatorul curent permisiunea de a șterge înregistrări în această sursă de date? Dacă nu este setat de sursa de date, returnează necompletat.
DataSourceInfo.EditPermission	Boolean	Are utilizatorul curent permisiunea de a edita înregistrări în această sursă de date? Dacă nu este setat de sursa de date, returnează necompletat.
DataSourceInfo.ReadPermission	Boolean	Are utilizatorul curent permisiunea de a citi înregistrări în această sursă de date? Dacă nu este setat de sursa de date, returnează necompletat.

Notă

DataSourceInfo returnează adevărat dacă nu poate stabili dacă utilizatorul actual are permisiunea solicitată. Permisiunile vor fi verificate din nou de către server atunci când se efectuează operațiunea efectivă și se afișează o eroare dacă nu a fost permisă. În acest moment, verificarea permisiunilor cu DataSourceInfo este posibilă numai atunci când se utilizează Microsoft Dataverse.

Sintaxă

DataSourceInfo( DataSource, Information [, ColumnName ])

• DataSource – Obligatoriu. Sursă de date de utilizat.
• Informații – Obligatoriu. Tipul de informații pe care doriți să le preluați.
• ColumnName – Opțional. Numele coloanei pentru care se recuperează informații la nivel de coloană. Pentru informații la nivelul sursei de date, argumentul ColumnName nu poate fi folosit.

Notă

În Power Apps înainte de versiunea 3.24042, numele coloanelor erau specificate cu un șir de text folosind ghilimele duble și, dacă erau conectate la un sursă de date, trebuiau să fie și nume logice. De exemplu, numele logic „cr43e_name” cu ghilimele duble a fost folosit în locul numelui afișat Nume fără ghilimele. Pentru sursele de date SharePoint și Excel care conțin nume de coloane cu spații, fiecare spațiu a fost specificat cu „_x0020_”, de exemplu „Column Name” as „Column_x0020_Name”. După această versiune, toate aplicațiile au fost actualizate automat la noua sintaxă descrisă în acest articol.

Exemple

Exemplele din această secțiune folosesc această sursă de date, denumită Înghețată:

Sursa de date a furnizat aceste informații:

• Numele afișat pentru Cantitate este "Cantitate în stoc".
• Lungimea maximă a adresei Aromă este de 30 de caractere.
• Coloana Tip trebuie să conțină o valoare. Coloana Cantitate nu este necesară.
• Valoarea Cantitate este 0.
• Valoarea maximă Cantitate este 100.
• Utilizatorul curent poate citi și edita înregistrările sursei de date Înghețată, dar nu poate crea sau șterge înregistrări.

Formulă	Descriere	Rezultat
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Quantity )	Returnează numele afișat pentru coloana Cantitate din sursa de date Înghețată.	"Cantitate în stoc"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Flavour )	Returnează lungimea maximă a șirului pentru coloana Aromă din sursa de date Înghețată.	30
DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor )	Este necesară coloana Aromă din sursa de date Înghețată?	true
DataSourceInfo( IceCream, DataSourceInfo.Required, Cantitate )	Este necesară coloana Cantitate din sursa de date Înghețată?	false
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Cantitate )	Returnează valoarea numerică maximă pentru coloana Cantitate din sursa de date Înghețată.	100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, Quantity )	Returnează valoarea numerică minimă pentru coloana Cantitate din sursa de date Înghețată.	0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission)	Poate utilizatorul curent să citească înregistrări din sursa de date Înghețată?	true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission)	Poate utilizatorul curent să editeze înregistrări din sursa de date Înghețată?	true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission)	Poate utilizatorul curent să creeze înregistrări din sursa de date Înghețată?	false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission)	Poate utilizatorul curent să șterge înregistrări din sursa de date Înghețată?	false