PowerApps の DataSourceInfo 関数DataSourceInfo function in PowerApps

データ ソースに関する情報を返します。Provides information about a data source.

概要Overview

データ ソースは、ユーザー エクスペリエンスの最適化に役立つさまざまな情報を提供できます。Data sources can provide a wealth of information to optimize the user experience.

Patch 関数を使用する前に、レベルの情報を使用して、ユーザー入力を検証し、ユーザーにすぐにフィードバックを返すことができます。You can use column-level information to validate user input and provide immediate feedback to the user before using the Patch function. Validate 関数では、これと同じ情報を使用します。The Validate function uses this same information.

データ ソース レベルの情報を使用して、たとえば、レコードを編集および作成するためのアクセス許可を持たないユーザーに対して、編集および新規作成用のボタンを無効または非表示にすることができます。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.

データ ソースが提供する情報の量は、データ ソースによって異なります。まったく情報を提供しないデータ ソースもあります。Data sources vary in how much information they provide, including not providing any at all. コレクションは情報を提供しません。Collections provide no information. 情報が提供されない場合は、既定値が使用されるか、"空白" が返されます。If a piece of information isn't provided, a default is used, or blank is returned.

説明Description

列の情報Column information

DataSourceInfo を使用すると、データ ソースの特定の列に関する次の情報を取得できます。You can use DataSourceInfo to obtain information about a particular column of a data source:

情報の引数Information Argument 結果の型Result Type 説明Description
DataSourceInfo.DisplayNameDataSourceInfo.DisplayName StringString 列の表示名。Display name for the column. 表示名が定義されていない場合は、列名を返します。If no display name is defined, returns the column name.
DataSourceInfo.MaxLengthDataSourceInfo.MaxLength NumberNumber 列が保持できる最大文字数。Maximum number of characters that the column can hold. 文字列が含まれている列にのみ適用されます。Applies only to columns that contain strings. 最大数が設定されていない場合は、"空白" を返します。If a maximum isn't set, returns blank.
DataSourceInfo.MaxValueDataSourceInfo.MaxValue NumberNumber 列が保持できる最大値。Maximum numeric value that a column can hold. 数値が含まれている列にのみ適用されます。Applies only to columns that contain numbers. 最大値が設定されていない場合は、"空白" を返します。If a maximum isn't set, returns blank.
DataSourceInfo.MinValueDataSourceInfo.MinValue NumberNumber 列が保持できる最小値。Minimum numeric value that a column can hold. 数値が含まれている列にのみ適用されます。Applies only to columns that contain numbers. 最小値が設定されていない場合は、"空白" を返します。If a minimum isn't set, returns blank.
DataSourceInfo.RequiredDataSourceInfo.Required BooleanBoolean この列の値が必須かどうか。Is a value required for this column? データ ソースで設定されていない場合は、false を返します。If not set by the data source, returns false.

3 番目の引数は、列の名前 (文字列) です。The third argument is the name of a column as a string. たとえば、People コレクションの Phone は、"Phone" として渡されます (二重引用符が含まれます)。For example, column Phone in collection People would be passed as "Phone" including the double quotes.

データ ソースの情報Data-source information

DataSourceInfo を使用すると、データ ソース全体に関する次の情報を取得することもできます。You can also use DataSourceInfo to obtain information about a data source as a whole:

情報の引数Information Argument 結果の型Result Type 説明Description
DataSourceInfo.AllowedValuesDataSourceInfo.AllowedValues BooleanBoolean このデータ ソースに対してユーザーに付与できるアクセス許可の種類。What types of permissions can users be granted for this data source? データ ソースで設定されていない場合は、"空白" を返します。If not set by the data source, returns blank.
DataSourceInfo.CreatePermissionDataSourceInfo.CreatePermission BooleanBoolean 現在のユーザーに対象データ ソースのレコードを作成するためのアクセス許可があるかどうか。Does the current user have permission to create records in this data source? データ ソースで設定されていない場合は、true を返します。If not set by the data source, returns true.
DataSourceInfo.DeletePermissionDataSourceInfo.DeletePermission BooleanBoolean 現在のユーザーに対象データ ソースのレコードを削除するためのアクセス許可があるかどうか。Does the current user have permission to delete records in this data source? データ ソースで設定されていない場合は、true を返します。If not set by the data source, returns true.
DataSourceInfo.EditPermissionDataSourceInfo.EditPermission BooleanBoolean 現在のユーザーに対象データ ソースのレコードを編集するためのアクセス許可があるかどうか。Does the current user have permission to edit records in this data source? データ ソースで設定されていない場合は、true を返します。If not set by the data source, returns true.
DataSourceInfo.ReadPermissionDataSourceInfo.ReadPermission BooleanBoolean 現在のユーザーに対象データ ソースのレコードを読み取るためのアクセス許可があるかどうか。Does the current user have permission to read records in this data source? データ ソースで設定されていない場合は、true を返します。If not set by the data source, returns true.

構文Syntax

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

  • DataSource – 必須。DataSource – Required. 使用するデータ ソース。The data source to use.
  • Information – 必須。Information – Required. 取得する情報の種類。The type of information that you want to retrieve.
  • ColumnName – 省略可能。ColumnName – Optional. 列レベルの情報の場合は、列名 (文字列)。For column-level information, the column name as a string. Phone は、"Phone" として渡されます (二重引用符が含まれます)。Column Phone would be passed as "Phone", including the double quotes. データ ソース レベルの情報の場合は、ColumnName 引数を使用することはできません。For information at the data-source level, the ColumnName argument can't be used.

    注: 名前にスペースが使われている列を含む SharePoint および Excel のデータ ソースの場合、各スペースを "_x0020_" として指定します。Note: For SharePoint and Excel data sources that contain column names with spaces, specify each space as "_x0020_". たとえば、"Column Name" として "Column_x0020_Name" を指定します。For example, specify "Column Name" as "Column_x0020_Name".

Examples

このセクションの例では、IceCream という名前のデータ ソースを使用します。The examples in this section use this data source, named IceCream:

このデータ ソースは、次の情報も提供します。The data source has also provided this information:

  • Quantity の表示名は "Quantity on Hand" です。The display name for Quantity is "Quantity on Hand".
  • Flavor の最大長は 30 文字です。The maximum length of Flavor is 30 characters.
  • Flavor 列には値を含める必要があります。The Flavor column must contain a value. Quantity 列は必須ではありません。The Quantity column isn't required.
  • Quantity の最小値は 0 です。The minimum Quantity is 0.
  • Quantity の最大値は 100 です。The maximum Quantity is 100.
  • 現在のユーザーは、IceCream データ ソースのレコードの読み取りと編集を行うことができますが、レコードを作成および削除することはできません。The current user can read and edit the records of the IceCream data source but can't create or delete records.
数式Formula 説明Description 結果Result
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) IceCream データ ソースの Quantity 列の表示名を返します。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" ) IceCream データ ソースの Flavor 列の文字列の最大長を返します。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" ) IceCream データ ソースの Flavor 列が必須かどうか。Is the Flavor column of the IceCream data source required? truetrue
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) IceCream データ ソースの Quantity 列が必須かどうか。Is the Quantity column of the IceCream data source required? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" )DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) IceCream データ ソースの Quantity 列の最大値を返します。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" ) IceCream データ ソースの Quantity 列の最小値を返します。Returns the minimum numeric value for the Quantity column of the IceCream data source. 00
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission)DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) 現在のユーザーが IceCream データ ソースのレコードを読み取ることができるかどうか。Can the current user read records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.EditPermission)DataSourceInfo( IceCream, DataSourceInfo.EditPermission) 現在のユーザーが IceCream データ ソースのレコードを編集できるかどうか。Can the current user edit records in the IceCream data source? truetrue
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission)DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) 現在のユーザーが IceCream データ ソースのレコードを作成できるかどうか。Can the current user create records in the IceCream data source? falsefalse
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission)DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) 現在のユーザーが IceCream データ ソースのレコードを削除できるかどうか。Can the current user delete records in the IceCream data source? falsefalse