DataSourceInfo-Funktion
Gilt für:
Canvas-Apps Modellgesteuerte Apps
Stellt Informationen über eine Datenquelle bereit
Überblick
Datenquellen können eine Fülle von Informationen bereitstellen, um die Benutzerfreundlichkeit zu optimieren.
Sie können Informationen auf Spaltenebene verwenden, um Benutzereingaben zu prüfen und dem Benutzer vor dem Verwenden der Patch-Funktion sofort Feedback zu geben. Die Validate-Funktion verwendet die gleichen Informationen.
Sie können Informationen auf Datenquellenebene z.B. verwenden, um die Schaltflächen Bearbeiten und Neu für Benutzer zu deaktivieren oder auszublenden, die keine Berechtigungen haben, Datensätze zu bearbeiten und zu erstellen.
Datenquellen stellen unterschiedlich viele Informationen zur Verfügung, manchmal sogar gar keine. Sammlungen geben keine Auskunft. Wenn eine Information nicht bereitgestellt wird, wird ein Standardwert verwendet, oder es wird blank (leer) zurückgegeben.
Notiz
Derzeit wird die Funktion DataSourceInfo in Microsoft Listen nicht unterstützt.
Eigenschaft
Spalteninformationen
Sie können DataSourceInfo verwenden, um Informationen über eine bestimmte Spalte einer Datenquelle zu erhalten:
| Informationsargument | Ergebnistyp | Beschreibung |
|---|---|---|
| DataSourceInfo.DisplayName | Zeichenfolge | Anzeigename für die Spalte. Wenn kein Anzeigename definiert ist, wird der Spaltennamen zurückgegeben. |
| DataSourceInfo.MaxLength | Anzahl | Maximale Anzahl von Zeichen, die die Spalte enthalten kann. Gilt nur für Spalten, die Zeichenfolgen enthalten. Wenn ein Maximum nicht festgelegt ist, wird blank zurückgegeben. |
| DataSourceInfo.MaxValue | Anzahl | Höchster numerischer Wert, den eine Spalte enthalten kann. Gilt nur für Spalten, die Zahlen enthalten. Wenn ein Maximum nicht festgelegt ist, wird blank zurückgegeben. |
| DataSourceInfo.MinValue | Anzahl | Niedrigster numerischer Wert, den eine Spalte enthalten kann. Gilt nur für Spalten, die Zahlen enthalten. Wenn ein Minimum nicht festgelegt ist, wird blank zurückgegeben. |
| DataSourceInfo.Erforderlich | Boolean | Ist ein Wert für diese Spalte erforderlich? Wenn nicht von der Datenquelle festgelegt, wird FALSE zurückgegeben. |
Das dritte Argument ist der Name einer Spalte als Zeichenfolge. Beispielsweise würde die Spalte Phone (Telefon) in der Sammlung People (Personen) würde als "Phone", inklusive der doppelten Anführungszeichen, übergeben werden.
Datenquelleninformationen
Sie können DataSourceInfo auch dazu verwenden, Informationen über die Datenquelle als Ganzes abzurufen:
| Informationsargument | Ergebnistyp | Beschreibung |
|---|---|---|
| DataSourceInfo.AllowedValues | Boolean | Welche Arten von Berechtigungen können Benutzern für diese Datenquelle werden erteilt? Gibt leer zurück, wenn von der Datenquelle nicht festgelegt. |
| DataSourceInfo.CreatePermission | Boolean | Verfügt der aktuelle Benutzer über die Berechtigung zum Erstellen von Datensätzen in dieser Datenquelle? Wenn nicht von der Datenquelle festgelegt, wird TRUE zurückgegeben. |
| DataSourceInfo.DeletePermission | Boolean | Verfügt der aktuelle Benutzer über die Berechtigung zum Löschen von Datensätzen in dieser Datenquelle? Wenn nicht von der Datenquelle festgelegt, wird TRUE zurückgegeben. |
| DataSourceInfo.EditPermission | Boolean | Verfügt der aktuelle Benutzer über die Berechtigung zum Bearbeiten von Datensätzen in dieser Datenquelle? Wenn nicht von der Datenquelle festgelegt, wird TRUE zurückgegeben. |
| DataSourceInfo.ReadPermission | Boolean | Verfügt der aktuelle Benutzer über die Berechtigung zum Lesen von Datensätzen in dieser Datenquelle? Wenn nicht von der Datenquelle festgelegt, wird wahr zurückgegeben. |
Notiz
DataSourceInfo gibt true zurück, wenn nicht ermittelt werden kann, ob der aktuelle Benutzer über die angeforderte Berechtigung verfügt. Die Berechtigungen werden vom Server erneut überprüft, wenn der eigentliche Vorgang ausgeführt wird, und ein Fehler wird angezeigt, wenn dies nicht zulässig war. Zur Zeit ist die Überprüfung von Berechtigungen mit DataSourceInfo nur bei Verwendung von Microsoft Dataverse möglich.
Syntax
DataSourceInfo( Datenquelle, Informationen [, Spaltenname] )
- DataSource : Erforderlich. Die zu verwendende Datenquelle.
- Informationen – Erforderlich. Der Typ von Information, den Sie abrufen möchten.
- ColumnName – Optional. Der Spaltenname, für den die Informationen auf Spaltenebene abgerufen werden sollen. Für Informationen auf Datenbankebene kann das Spaltenname-Argument nicht verwendet werden.
Anmerkung
In Power Apps vor Version 3.24042 wurden Spaltennamen mit einer Textzeichenfolge in Anführungszeichen angegeben. Wenn sie mit einer Datenquelle verbunden waren, mussten es auch logische Namen sein. Beispielsweise wurde der logische Name „cr43e_name“ mit Anführungszeichen anstelle des Anzeigenamens Name ohne Anführungszeichen verwendet. Für SharePoint- und Excel-Datenquellen, die Spaltennamen mit Leerzeichen enthalten, wurde jedes Leerzeichen mit „_x0020_“ angegeben, zum Beispiel „Column Name“ als „Column_x0020_Name“. Nach dieser Version wurden alle Apps automatisch auf die in diesem Artikel beschriebene neue Syntax aktualisiert.
Beispiele
In den Beispielen in diesem Abschnitt wird diese Datenquelle namens IceCream (Eiscreme) verwendet:
Die Datenquelle hat zudem diese Informationen bereitgestellt:
- Der Anzeigename für Quantity (Menge) ist "Quantity on Hand" (Lagerbestand).
- Die maximale Länge von Flavor (Sorte) beträgt 30 Zeichen.
- Die Spalte Flavor muss einen Wert enthalten. Die Spalte Quantity ist nicht erforderlich.
- Der minimale Wert für Quantity ist 0.
- Der maximale Wert für Quantity ist 100.
- Der aktuelle Benutzer kann die Datensätze der Datenquelle IceCream lesen und bearbeiten, jedoch keine Datensätze erstellen oder löschen.
| Formel | Beschreibung | Ergebnis |
|---|---|---|
| DataSourceInfo( Eiscreme, DataSourceInfo.DisplayName, Menge ) | Gibt den Anzeigenamen für die Spalte Quantity der Datenquelle IceCream zurück | „Lagerbestandsmenge“ |
| DataSourceInfo(Eiscreme, DataSourceInfo.MaxLength, Geschmack) | Gibt die maximale Länge der Zeichenfolge für die Spalte Flavor der Datenquelle IceCream zurück. | 30 |
| DataSourceInfo(Eiscreme, DataSourceInfo.Erforderlich, Geschmack) | Ist die Spalte Flavor der Datenquelle IceCream erforderlich? | WAHR |
| DataSourceInfo(Eiscreme, DataSourceInfo.Erforderlich, Menge) | Ist die Spalte Quantity der Datenquelle IceCream erforderlich? | FALSCH |
| DataSourceInfo(Eiscreme, DataSourceInfo.MaxWert, Menge) | Gibt den höchsten numerischen Wert für die Spalte Quantity der Datenquelle IceCream zurück | 100 |
| DataSourceInfo(Eiscreme, DataSourceInfo.Mindestwert, Menge) | Gibt den niedrigsten numerischen Wert für die Spalte Quantity der Datenquelle IceCream zurück | 0 |
| DataSourceInfo(Eiscreme, DataSourceInfo.ReadPermission) | Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream lesen? | WAHR |
| DataSourceInfo(Eiscreme, DataSourceInfo.EditPermission) | Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream bearbeiten? | WAHR |
| DataSourceInfo(IceCream, DataSourceInfo.Erstellen einer Berechtigungen) | Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream erstellen? | FALSCH |
| DataSourceInfo(IceCream, DataSourceInfo.DeletePermission) | Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream löschen? | FALSCH |