Função DataSourceInfo no PowerAppsDataSourceInfo function in PowerApps

Fornece informações sobre uma fonte de dados.Provides information about a data source.

Visão geralOverview

Fontes de dados podem fornecer uma infinidade de informações para otimizar a experiência do usuário.Data sources can provide a wealth of information to optimize the user experience.

Você pode usar as informações a nível de coluna para validar a entrada do usuário e fornecer comentários imediatos ao usuário antes de usar a função Patch.You can use column-level information to validate user input and provide immediate feedback to the user before using the Patch function. A função validar usa essas mesmas informações.The Validate function uses this same information.

Você pode usar informações no nível de fonte de dados, por exemplo, para desativar ou ocultar os botões Editar e Novo para usuários que não têm permissões para editar nem criar registros.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.

O volume de informações fornecidas pelas fontes de dados varia, incluindo não fornecer informação alguma.Data sources vary in how much information they provide, including not providing any at all. Coleções não fornecem informações.Collections provide no information. Se parte das informações não for fornecida, serão usadas as opções padrão, ou retornará em branco.If a piece of information isn't provided, a default is used, or blank is returned.

DescriçãoDescription

Informações de colunaColumn information

Você pode usar o DataSourceInfo para obter informações sobre uma determinada coluna de uma fonte de dados:You can use DataSourceInfo to obtain information about a particular column of a data source:

Argumento de informaçõesInformation Argument Tipo de resultadoResult Type DescriçãoDescription
DataSourceInfo.DisplayNameDataSourceInfo.DisplayName Cadeia de caracteresString Nome de exibição para a coluna.Display name for the column. Se nenhum nome de exibição for definido, retornará o nome da coluna.If no display name is defined, returns the column name.
DataSourceInfo.MaxLengthDataSourceInfo.MaxLength NúmeroNumber Número máximo de caracteres que a coluna pode conter.Maximum number of characters that the column can hold. Aplica-se somente às colunas que contenham cadeias de caracteres.Applies only to columns that contain strings. Se um máximo não for definido, retornará em branco.If a maximum isn't set, returns blank.
DataSourceInfo.MaxValueDataSourceInfo.MaxValue NúmeroNumber Valor numérico máximo que uma coluna pode conter.Maximum numeric value that a column can hold. Aplica-se somente às colunas que contêm números.Applies only to columns that contain numbers. Se um máximo não for definido, retornará em branco.If a maximum isn't set, returns blank.
DataSourceInfo.MinValueDataSourceInfo.MinValue NúmeroNumber Valor numérico mínimo que uma coluna pode conter.Minimum numeric value that a column can hold. Aplica-se somente às colunas que contêm números.Applies only to columns that contain numbers. Se um mínimo não for definido, retornará em branco.If a minimum isn't set, returns blank.
DataSourceInfo.RequiredDataSourceInfo.Required BooleanoBoolean Essa coluna exige um valor específico?Is a value required for this column? Se não for definido pela fonte de dados, retornará como falso.If not set by the data source, returns false.

O terceiro argumento é o nome de uma coluna como uma cadeia de caracteres.The third argument is the name of a column as a string. Por exemplo, a coluna Telefone na coleção Pessoas seria nomeada como "Telefone" com aspas duplas.For example, column Phone in collection People would be passed as "Phone" including the double quotes.

Informações da fonte de dadosData-source information

Você também pode usar o DataSourceInfo para obter informações sobre uma fonte de dados como um todo:You can also use DataSourceInfo to obtain information about a data source as a whole:

Argumento de informaçõesInformation Argument Tipo de resultadoResult Type DescriçãoDescription
DataSourceInfo.AllowedValuesDataSourceInfo.AllowedValues BooleanoBoolean Quais tipos de permissões podem ser concedidos aos usuários nessa fonte de dados?What types of permissions can users be granted for this data source? Se isso não for definido pela fonte de dados, retornará blank.If not set by the data source, returns blank.
DataSourceInfo.CreatePermissionDataSourceInfo.CreatePermission BooleanoBoolean O usuário atual tem permissão para criar registros nessa fonte de dados?Does the current user have permission to create records in this data source? Se não definida pela fonte de dados, retornará como verdadeiro.If not set by the data source, returns true.
DataSourceInfo.DeletePermissionDataSourceInfo.DeletePermission BooleanoBoolean O usuário atual tem permissão para excluir registros nessa fonte de dados?Does the current user have permission to delete records in this data source? Se não definida pela fonte de dados, retornará como verdadeiro.If not set by the data source, returns true.
DataSourceInfo.EditPermissionDataSourceInfo.EditPermission BooleanoBoolean O usuário atual tem permissão para editar os registros nessa fonte de dados?Does the current user have permission to edit records in this data source? Se não definida pela fonte de dados, retornará como verdadeiro.If not set by the data source, returns true.
DataSourceInfo.ReadPermissionDataSourceInfo.ReadPermission BooleanoBoolean O usuário atual tem permissão para ler registros nessa fonte de dados?Does the current user have permission to read records in this data source? Se não definida pela fonte de dados, retornará como verdadeiro.If not set by the data source, returns true.

SintaxeSyntax

DataSourceInfo( DataSource, Informações, ColumnName )DataSourceInfo( DataSource, Information, ColumnName )

  • DataSource – obrigatório.DataSource – Required. A fonte de dados a ser usada.The data source to use.
  • Informações – obrigatório.Information – Required. O tipo de informações que você deseja recuperar.The type of information that you want to retrieve.
  • ColumnName – opcional.ColumnName – Optional. Para informações de nível de coluna, o nome da coluna como uma cadeia de caracteres.For column-level information, the column name as a string. A coluna Telefone seria nomeada como "Telefone" com aspas duplas.Column Phone would be passed as "Phone", including the double quotes. Para obter informações no nível de fonte de dados, o argumento ColumnName não pode ser usado.For information at the data-source level, the ColumnName argument can't be used.

    Observação: nas fontes de dados do Excel e do SharePoint que contêm nomes de colunas com espaços, especifique cada espaço como "_x0020_".Note: For SharePoint and Excel data sources that contain column names with spaces, specify each space as "_x0020_". Por exemplo, especifique "Nome da Coluna" como "Nome_x0020_da_x0020_Coluna".For example, specify "Column Name" as "Column_x0020_Name".

ExemplosExamples

Os exemplos nesta seção usam essa fonte de dados, chamada Sorvete:The examples in this section use this data source, named IceCream:

A fonte de dados também fornece essas informações:The data source has also provided this information:

  • O nome de exibição em Quantidade é "Quantidade disponível".The display name for Quantity is "Quantity on Hand".
  • O comprimento máximo de Sabor é de 30 caracteres.The maximum length of Flavor is 30 characters.
  • A coluna Sabor deve conter um valor.The Flavor column must contain a value. A coluna Quantidade não é necessária.The Quantity column isn't required.
  • O valor mínimo para Quantidade é 0.The minimum Quantity is 0.
  • O valor máximo para Quantidade é 100.The maximum Quantity is 100.
  • O usuário atual pode ler e editar os registros da fonte de dados Sorvete, mas não pode criar nem excluir registros.The current user can read and edit the records of the IceCream data source but can't create or delete records.
FórmulaFormula DescriçãoDescription ResultadoResult
DataSourceInfo( Sorvete, DataSourceInfo.DisplayName, "Quantidade" )DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) Retorna o nome de exibição da coluna Quantidade da fonte de dados Sorvete.Returns the display name for the Quantity column of the IceCream data source. "Quantidade disponível""Quantity on Hand"
DataSourceInfo( Sorvete, DataSourceInfo.MaxLength, "Sabor" )DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) Retorna o comprimento máximo da cadeia de caracteres da coluna Sabor da fonte de dados Sorvete.Returns the maximum length of the string for the Flavor column of the IceCream data source. 3030
DataSourceInfo ( Sorvete, DataSourceInfo.Required, "Sabor" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) A coluna Sabor da fonte de dados Sorvete é necessária?Is the Flavor column of the IceCream data source required? verdadeirotrue
DataSourceInfo ( Sorvete, DataSourceInfo.Required, "Quantidade" )DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) A coluna Quantidade da fonte de dados Sorvete é necessária?Is the Quantity column of the IceCream data source required? falsofalse
DataSourceInfo ( Sorvete, DataSourceInfo.MaxValue, "Quantidade" )DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) Retorna o valor numérico máximo para a coluna Quantidade da fonte de dados Sorvete.Returns the maximum numeric value for the Quantity column of the IceCream data source. 100100
DataSourceInfo ( Sorvete, DataSourceInfo.MinValue, "Quantidade" )DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) Retorna o menor valor numérico para a coluna Quantidade da fonte de dados Sorvete.Returns the minimum numeric value for the Quantity column of the IceCream data source. 00
DataSourceInfo ( Sorvete, DataSourceInfo.ReadPermission)DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) O usuário atual tem permissão para ler registros da fonte de dados Sorvete?Can the current user read records in the IceCream data source? verdadeirotrue
DataSourceInfo ( Sorvete, DataSourceInfo.EditPermission)DataSourceInfo( IceCream, DataSourceInfo.EditPermission) O usuário atual tem permissão para editar registros na fonte de dados Sorvete?Can the current user edit records in the IceCream data source? verdadeirotrue
DataSourceInfo ( Sorvete, DataSourceInfo.CreatePermission)DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) O usuário atual tem permissão para criar registros na fonte de dados Sorvete?Can the current user create records in the IceCream data source? falsofalse
DataSourceInfo ( Sorvete, DataSourceInfo.DeletePermission)DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) O usuário atual tem permissão para excluir registros da fonte de dados Sorvete?Can the current user delete records in the IceCream data source? falsofalse