Funktion „DataSourceInfo“ in PowerAppsDataSourceInfo function in PowerApps

Stellt Informationen über eine Datenquelle bereitProvides information about a data source.

ÜbersichtOverview

Datenquellen können eine Fülle von Informationen bereitstellen, um die Benutzerfreundlichkeit zu optimieren.Data sources can provide a wealth of information to optimize the user experience.

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.You can use column-level information to validate user input and provide immediate feedback to the user before using the Patch function. Die Validate-Funktion verwendet die gleichen Informationen.The Validate function uses this same information.

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.You can use information at the data-source level, for example, to disable or hide Edit and New buttons for users who don't have permissions to edit and create records.

Datenquellen stellen unterschiedlich viele Informationen zur Verfügung, manchmal sogar gar keine.Data sources vary in how much information they provide, including not providing any at all. Sammlungen stellen keine Informationen bereit.Collections provide no information. Wenn eine Information nicht bereitgestellt wird, wird ein Standardwert verwendet, oder es wird blank (leer) zurückgegeben.If a piece of information isn't provided, a default is used, or blank is returned.

BeschreibungDescription

SpalteninformationenColumn information

Sie können DataSourceInfo verwenden, um Informationen über eine bestimmte Spalte einer Datenquelle zu erhalten:You can use DataSourceInfo to obtain information about a particular column of a data source:

InformationsargumentInformation Argument ErgebnistypResult Type BeschreibungDescription
DataSourceInfo.DisplayNameDataSourceInfo.DisplayName ZeichenfolgeString Anzeigename für die Spalte.Display name for the column. Wenn kein Anzeigename definiert ist, wird der Spaltennamen zurückgegeben.If no display name is defined, returns the column name.
DataSourceInfo.MaxLengthDataSourceInfo.MaxLength NumberNumber Maximale Anzahl von Zeichen, die die Spalte enthalten kann.Maximum number of characters that the column can hold. Gilt nur für Spalten, die Zeichenfolgen enthalten.Applies only to columns that contain strings. Wenn ein Maximum nicht festgelegt ist, wird blank zurückgegeben.If a maximum isn't set, returns blank.
DataSourceInfo.MaxValueDataSourceInfo.MaxValue NumberNumber Höchster numerischer Wert, den eine Spalte enthalten kann.Maximum numeric value that a column can hold. Gilt nur für Spalten, die Zahlen enthalten.Applies only to columns that contain numbers. Wenn ein Maximum nicht festgelegt ist, wird blank zurückgegeben.If a maximum isn't set, returns blank.
DataSourceInfo.MinValueDataSourceInfo.MinValue NumberNumber Niedrigster numerischer Wert, den eine Spalte enthalten kann.Minimum numeric value that a column can hold. Gilt nur für Spalten, die Zahlen enthalten.Applies only to columns that contain numbers. Wenn ein Minimum nicht festgelegt ist, wird blank zurückgegeben.If a minimum isn't set, returns blank.
DataSourceInfo.RequiredDataSourceInfo.Required Boolescher WertBoolean Ist ein Wert für diese Spalte erforderlich?Is a value required for this column? Wenn nicht von der Datenquelle festgelegt, wird FALSE zurückgegeben.If not set by the data source, returns false.

Das dritte Argument ist der Name einer Spalte als Zeichenfolge.The third argument is the name of a column as a string. Beispielsweise würde die Spalte Phone (Telefon) in der Sammlung People (Personen) würde als "Phone", inklusive der doppelten Anführungszeichen, übergeben werden.For example, column Phone in collection People would be passed as "Phone" including the double quotes.

DatenquelleninformationenData-source information

Sie können DataSourceInfo auch dazu verwenden, Informationen über die Datenquelle als Ganzes abzurufen:You can also use DataSourceInfo to obtain information about a data source as a whole:

InformationsargumentInformation Argument ErgebnistypResult Type BeschreibungDescription
DataSourceInfo.AllowedValuesDataSourceInfo.AllowedValues Boolescher WertBoolean Welche Arten von Berechtigungen können Benutzern für diese Datenquelle werden erteilt?What types of permissions can users be granted for this data source? Gibt leer zurück, wenn von der Datenquelle nicht festgelegt.If not set by the data source, returns blank.
DataSourceInfo.CreatePermissionDataSourceInfo.CreatePermission Boolescher WertBoolean Verfügt der aktuelle Benutzer über die Berechtigung zum Erstellen von Datensätzen in dieser Datenquelle?Does the current user have permission to create records in this data source? Wenn nicht von der Datenquelle festgelegt, wird TRUE zurückgegeben.If not set by the data source, returns true.
DataSourceInfo.DeletePermissionDataSourceInfo.DeletePermission Boolescher WertBoolean Verfügt der aktuelle Benutzer über die Berechtigung zum Löschen von Datensätzen in dieser Datenquelle?Does the current user have permission to delete records in this data source? Wenn nicht von der Datenquelle festgelegt, wird TRUE zurückgegeben.If not set by the data source, returns true.
DataSourceInfo.EditPermissionDataSourceInfo.EditPermission Boolescher WertBoolean Verfügt der aktuelle Benutzer über die Berechtigung zum Bearbeiten von Datensätzen in dieser Datenquelle?Does the current user have permission to edit records in this data source? Wenn nicht von der Datenquelle festgelegt, wird TRUE zurückgegeben.If not set by the data source, returns true.
DataSourceInfo.ReadPermissionDataSourceInfo.ReadPermission Boolescher WertBoolean Verfügt der aktuelle Benutzer über die Berechtigung zum Lesen von Datensätzen in dieser Datenquelle?Does the current user have permission to read records in this data source? Wenn nicht von der Datenquelle festgelegt, wird TRUE zurückgegeben.If not set by the data source, returns true.

SyntaxSyntax

DataSourceInfo( Datenquelle, Information, Spaltenname )DataSourceInfo( DataSource, Information, ColumnName )

  • Datenquelle: Erforderlich.DataSource – Required. Die zu verwendende Datenquelle.The data source to use.
  • Information: Erforderlich.Information – Required. Der Typ von Information, den Sie abrufen möchten.The type of information that you want to retrieve.
  • Spaltenname: Optional.ColumnName – Optional. Bei Informationen auf Spaltenebene der Spaltenname als Zeichenfolge.For column-level information, the column name as a string. Die Spalte Phone würde als "Phone", inklusive der doppelten Anführungszeichen, übergeben werden.Column Phone would be passed as "Phone", including the double quotes. Für Informationen auf Datenbankebene kann das Spaltenname-Argument nicht verwendet werden.For information at the data-source level, the ColumnName argument can't be used.

    Hinweis: Bei Excel- oder SharePoint-Datenquellen, die Spaltennamen mit Leerzeichen enthalten, geben Sie jedes Leerzeichen als "_X0020_" an.Note: For SharePoint and Excel data sources that contain column names with spaces, specify each space as "_x0020_". "Name der Spalte" wird z.B. als "Name_x0020_der_x0020_Spalte" angegeben.For example, specify "Column Name" as "Column_x0020_Name".

BeispieleExamples

In den Beispielen in diesem Abschnitt wird diese Datenquelle namens IceCream (Eiscreme) verwendet:The examples in this section use this data source, named IceCream:

Die Datenquelle hat zudem diese Informationen bereitgestellt:The data source has also provided this information:

  • Der Anzeigename für Quantity (Menge) ist "Quantity on Hand" (Lagerbestand).The display name for Quantity is "Quantity on Hand".
  • Die maximale Länge von Flavor (Sorte) beträgt 30 Zeichen.The maximum length of Flavor is 30 characters.
  • Die Spalte Flavor muss einen Wert enthalten.The Flavor column must contain a value. Die Spalte Quantity ist nicht erforderlich.The Quantity column isn't required.
  • Der minimale Wert für Quantity ist 0.The minimum Quantity is 0.
  • Der maximale Wert für Quantity ist 100.The maximum Quantity is 100.
  • Der aktuelle Benutzer kann die Datensätze der Datenquelle IceCream lesen und bearbeiten, jedoch keine Datensätze erstellen oder löschen.The current user can read and edit the records of the IceCream data source but can't create or delete records.
FormelFormula BeschreibungDescription ErgebnisResult
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) Gibt den Anzeigenamen für die Spalte Quantity der Datenquelle IceCream zurückReturns the display name for the Quantity column of the IceCream data source. "Quantity on Hand" (Lagerbestand)"Quantity on Hand"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" )DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) Gibt die maximale Länge der Zeichenfolge für die Spalte Flavor der Datenquelle IceCream zurück.Returns the maximum length of the string for the Flavor column of the IceCream data source. 3030
DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) Ist die Spalte Flavor der Datenquelle IceCream erforderlich?Is the Flavor column of the IceCream data source required? TRUEtrue
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) Ist die Spalte Quantity der Datenquelle IceCream erforderlich?Is the Quantity column of the IceCream data source required? FALSEfalse
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) Gibt den höchsten numerischen Wert für die Spalte Quantity der Datenquelle IceCream zurückReturns the maximum numeric value for the Quantity column of the IceCream data source. 100100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) Gibt den niedrigsten numerischen Wert für die Spalte Quantity der Datenquelle IceCream zurückReturns the minimum numeric value for the Quantity column of the IceCream data source. 00
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission)DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream lesen?Can the current user read records in the IceCream data source? TRUEtrue
DataSourceInfo( IceCream, DataSourceInfo.EditPermission)DataSourceInfo( IceCream, DataSourceInfo.EditPermission) Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream bearbeiten?Can the current user edit records in the IceCream data source? TRUEtrue
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission)DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream erstellen?Can the current user create records in the IceCream data source? FALSEfalse
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission)DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream löschen?Can the current user delete records in the IceCream data source? FALSEfalse