Freigeben über

DataSourceInfo-Funktion

  • Artikel

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:

Icecream Beispiel.

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