Fonction DataSourceInfo dans PowerAppsDataSourceInfo function in PowerApps

Fournit des informations sur une source de données.Provides information about a data source.

Vue d’ensembleOverview

Les sources de données sont une véritable manne d’informations et optimisent ainsi l’expérience utilisateur.Data sources can provide a wealth of information to optimize the user experience.

Vous pouvez utiliser les informations au niveau de la colonne pour valider les saisies de l’utilisateur et lui fournir des commentaires immédiats avant d’utiliser la fonction Patch.You can use column-level information to validate user input and provide immediate feedback to the user before using the Patch function. La fonction Validate utilise les mêmes informations.The Validate function uses this same information.

Vous pouvez utiliser les informations au niveau de la source de données, par exemple pour désactiver ou masquer les boutons Modifier et Nouveau lorsque les utilisateurs ne sont pas autorisés à modifier et à créer des enregistrements.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.

Les sources de données ne fournissent pas toutes la même quantité d’informations. Parfois même, elles n’en fournissent aucune.Data sources vary in how much information they provide, including not providing any at all. Les collections ne fournissent aucune information.Collections provide no information. Si un élément d’information n’est pas fourni, une valeur par défaut est utilisée ou une valeur vide est renvoyée.If a piece of information isn't provided, a default is used, or blank is returned.

DescriptionDescription

Informations sur les colonnesColumn information

Vous pouvez utiliser DataSourceInfo pour obtenir des informations sur une colonne en particulier d’une source de données :You can use DataSourceInfo to obtain information about a particular column of a data source:

Argument d’informationsInformation Argument Type de résultatResult Type DescriptionDescription
DataSourceInfo.DisplayNameDataSourceInfo.DisplayName ChaîneString Nom d’affichage de la colonne.Display name for the column. Si aucun nom d’affichage n’est défini, renvoie le nom de colonne.If no display name is defined, returns the column name.
DataSourceInfo.MaxLengthDataSourceInfo.MaxLength NombreNumber Nombre maximal de caractères que peut contenir la colonne.Maximum number of characters that the column can hold. S’applique uniquement aux colonnes qui contiennent des chaînes.Applies only to columns that contain strings. Si aucune valeur maximale n’est définie, renvoie vide.If a maximum isn't set, returns blank.
DataSourceInfo.MaxValueDataSourceInfo.MaxValue NombreNumber Valeur numérique maximale qu’une colonne peut contenir.Maximum numeric value that a column can hold. S’applique uniquement aux colonnes qui contiennent des nombres.Applies only to columns that contain numbers. Si aucune valeur maximale n’est définie, renvoie vide.If a maximum isn't set, returns blank.
DataSourceInfo.MinValueDataSourceInfo.MinValue NombreNumber Valeur numérique minimale qu’une colonne peut contenir.Minimum numeric value that a column can hold. S’applique uniquement aux colonnes qui contiennent des nombres.Applies only to columns that contain numbers. Si aucune valeur minimale n’est définie, renvoie vide.If a minimum isn't set, returns blank.
DataSourceInfo.RequiredDataSourceInfo.Required Valeur booléenneBoolean Une valeur est-elle attendue pour cette colonne ?Is a value required for this column? Si elle n’est pas définie par la source de données, renvoie false.If not set by the data source, returns false.

Le troisième argument est le nom d’une colonne en tant que chaîne.The third argument is the name of a column as a string. Par exemple, la colonne Phone dans la collection People est transmise en tant que "Phone" avec des guillemets doubles.For example, column Phone in collection People would be passed as "Phone" including the double quotes.

Informations sur la source de donnéesData-source information

Vous pouvez également utiliser DataSourceInfo pour obtenir des informations sur une source de données dans son ensemble :You can also use DataSourceInfo to obtain information about a data source as a whole:

Argument d’informationsInformation Argument Type de résultatResult Type DescriptionDescription
DataSourceInfo.AllowedValuesDataSourceInfo.AllowedValues Valeur booléenneBoolean Quels types d’autorisations peuvent être accordées aux utilisateurs pour cette source de données ?What types of permissions can users be granted for this data source? Si rien n’est défini par la source de données, retourne vide.If not set by the data source, returns blank.
DataSourceInfo.CreatePermissionDataSourceInfo.CreatePermission Valeur booléenneBoolean L’utilisateur actuel dispose-il d’autorisations pour créer des enregistrements dans cette source de données ?Does the current user have permission to create records in this data source? Si rien n’est défini par la source de données, renvoie true.If not set by the data source, returns true.
DataSourceInfo.DeletePermissionDataSourceInfo.DeletePermission Valeur booléenneBoolean L’utilisateur actuel dispose-il d’autorisations pour supprimer des enregistrements dans cette source de données ?Does the current user have permission to delete records in this data source? Si rien n’est défini par la source de données, renvoie true.If not set by the data source, returns true.
DataSourceInfo.EditPermissionDataSourceInfo.EditPermission Valeur booléenneBoolean L’utilisateur actuel dispose-il d’autorisations pour modifier des enregistrements dans cette source de données ?Does the current user have permission to edit records in this data source? Si rien n’est défini par la source de données, renvoie true.If not set by the data source, returns true.
DataSourceInfo.ReadPermissionDataSourceInfo.ReadPermission Valeur booléenneBoolean L’utilisateur actuel dispose-il d’autorisations pour lire des enregistrements dans cette source de données ?Does the current user have permission to read records in this data source? Si rien n’est défini par la source de données, renvoie true.If not set by the data source, returns true.

SyntaxeSyntax

DataSourceInfo( DataSource, Information, ColumnName )DataSourceInfo( DataSource, Information, ColumnName )

  • DataSource : requis.DataSource – Required. Source de données à utiliser.The data source to use.
  • Information : requis.Information – Required. Type d’informations à récupérer.The type of information that you want to retrieve.
  • ColumnName : facultatif.ColumnName – Optional. Nom de la colonne sous forme de chaîne pour plus d’informations au niveau de la colonne.For column-level information, the column name as a string. Par exemple, la colonne Phone est transmise en tant que "Phone" avec des guillemets doubles.Column Phone would be passed as "Phone", including the double quotes. Pour plus d’informations au niveau de la source de données, l’argument ColumnName ne peut pas être utilisé.For information at the data-source level, the ColumnName argument can't be used.

    Note

    Pour des sources de données Excel ou SharePoint contenant des noms de colonne avec des espaces, spécifiez ceux-ci sous la forme « _x0020_ ».For SharePoint and Excel data sources that contain column names with spaces, specify each space as "_x0020_". Par exemple, spécifiez « Nom de colonne » sous la forme « Nom_x0020_de_x0020_colonne ».For example, specify "Column Name" as "Column_x0020_Name".

ExemplesExamples

Dans les exemples de cette section, nous utilisons une source de données appelée IceCream :The examples in this section use this data source, named IceCream:

Cette source de données fournit également les informations suivantes :The data source has also provided this information:

  • Le nom d’affichage pour Quantity est "Quantity on Hand".The display name for Quantity is "Quantity on Hand".
  • La longueur maximale de Flavor est de 30 caractères.The maximum length of Flavor is 30 characters.
  • La colonne Flavor doit contenir une valeur.The Flavor column must contain a value. La colonne Quantity n’est pas requise.The Quantity column isn't required.
  • La valeur minimale de Quantity est 0.The minimum Quantity is 0.
  • La valeur maximale de Quantity est 100.The maximum Quantity is 100.
  • L’utilisateur actuel peut lire et modifier les enregistrements de la source de données IceCream, mais il ne peut pas en créer ni en supprimer.The current user can read and edit the records of the IceCream data source but can't create or delete records.
FormuleFormula DescriptionDescription RésultatResult
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) Renvoie le nom complet de la colonne Quantity de la source de données IceCream.Returns the display name for the Quantity column of the IceCream data source. "Quantity on Hand""Quantity on Hand"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" )DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) Renvoie la longueur maximale de la chaîne pour la colonne Flavor de la source de données IceCream.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" ) La colonne Flavor de la source de données IceCream est-elle requise ?Is the Flavor column of the IceCream data source required? truetrue
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) La colonne Quantity de la source de données IceCream est-elle requise ?Is the Quantity column of the IceCream data source required? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) Renvoie la valeur numérique maximale de la colonne Quantity de la source de données IceCream.Returns the maximum numeric value for the Quantity column of the IceCream data source. 100100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) Renvoie la valeur numérique minimale de la colonne Quantity de la source de données IceCream.Returns the minimum numeric value for the Quantity column of the IceCream data source. 00
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission)DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) L’utilisateur actuel peut-il lire les enregistrements dans la source de données IceCream ?Can the current user read records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.EditPermission)DataSourceInfo( IceCream, DataSourceInfo.EditPermission) L’utilisateur actuel peut-il modifier les enregistrements de la source de données IceCream ?Can the current user edit records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission)DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) L’utilisateur actuel peut-il créer des enregistrements dans la source de données IceCream ?Can the current user create records in the IceCream data source? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission)DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) L’utilisateur actuel peut-il supprimer des enregistrements de la source de données IceCream ?Can the current user delete records in the IceCream data source? falsefalse