Função DataSourceInfo
Aplica-se a:
Aplicativos de tela Aplicativos controlados por modelo
Fornece informações sobre a origem de dados.
Descrição geral
As origens de dados podem fornecer uma variedade de informações para otimizar a experiência de utilizador.
Pode utilizar informações da coluna para validar a entrada do utilizador e fornecer comentários imediatos ao utilizador antes de utilizar a função Patch. A função Validate utiliza essas mesmas informações.
Pode utilizar informações ao nível da origem de dados, por exemplo, para desativar ou ocultar os botões Editar e Novo para os utilizadores que não tem permissão para editar e criar registos.
As origens de dados variam na quantidade de informações que fornecem, incluindo o não fornecimento de qualquer informação. As coleções não fornecem informações. Se não for fornecido um elemento de informação, é utilizado um elemento predefinido ou é devolvido um elemento blank.
Nota
Atualmente, a função DataSourceInfo não é suportada em Microsoft listas.
Description
Informações das colunas
Pode utilizar DataSourceInfo para obter informações sobre uma coluna específica de uma origem de dados:
| Argumento de informações | Tipo de Resultado | Descrição |
|---|---|---|
| DataSourceInfo.DisplayName | String | Nome a apresentar para a coluna. Se não for definido nenhum nome a apresentar, será devolvido o nome da coluna. |
| DataSourceInfo.MaxLength | Número | Número máximo de carateres que a coluna pode conter. Aplica-se apenas às colunas com cadeias. Se não estiver configurado um número máximo, será devolvido um valor blank. |
| DataSourceInfo.MaxValue | Número | Valor numérico máximo que uma coluna pode conter. Aplica-se apenas às colunas com números. Se não estiver configurado um número máximo, será devolvido um valor blank. |
| DataSourceInfo.MinValue | Número | Valor numérico mínimo que uma coluna pode conter. Aplica-se apenas às colunas com números. Se não estiver configurado um número mínimo, será devolvido um valor blank. |
| DataSourceInfo.Required | Booleano | É um valor necessário para esta coluna? Se não tiver sido definido pela origem de dados, será devolvido um valor false. |
O terceiro argumento é o nome de uma coluna como uma cadeia. Por exemplo, a coluna Telefone na coleção Pessoas foi transferida para "Telefone", incluindo as aspas.
Informações da origem de dados
Também pode utilizar DataSourceInfo para obter informações sobre uma origem de dados como um todo:
| Argumento de informações | Tipo de Resultado | Descrição |
|---|---|---|
| DataSourceInfo.AllowedValues | Booleano | Que tipos de permissões podem ser concedidos aos utilizadores para esta origem de dados? Se não tiver sido definido pela origem de dados, será devolvido um valor blank. |
| DataSourceInfo.CreatePermission | Booleano | O utilizador atual tem permissão para criar registos nesta origem de dados? Se não tiver sido definida pela origem de dados, será devolvido um valor true. |
| DataSourceInfo.DeletePermission | Booleano | O utilizador atual tem permissão para eliminar registos nesta origem de dados? Se não tiver sido definida pela origem de dados, será devolvido um valor true. |
| DataSourceInfo.EditPermission | Booleano | O utilizador atual tem permissão para editar registos nesta origem de dados? Se não tiver sido definida pela origem de dados, será devolvido um valor true. |
| DataSourceInfo.ReadPermission | Booleano | O utilizador atual tem permissão para ler registos nesta origem de dados? Se não tiver sido definida pela origem de dados, será devolvido um valor true. |
Nota
DataSourceInfo retornará true se não puder determinar se o utente atual tem a permissão solicitada. As permissões serão novamente verificadas pelo servidor quando a operação real for efetuada e um erro será apresentado se não for permitida. Neste momento, a verificação das permissões com DataSourceInfo só é possível quando se utiliza Microsoft Dataverse.
Sintaxe
DataSourceInfo( DataSource,Information [, ColumnName] )
- DataSource – Obrigatório. A origem de dados a utilizar.
- Informação – Obrigatório. O tipo de informações que pretende obter.
- ColumnName – Opcional. O nome da coluna para o qual vai obter informações ao nível da coluna. Para obter informações ao nível da origem de dados, o argumento ColumnName não pode ser utilizado.
Nota
Antes da versão 3.24042 do Power Apps, os nomes das colunas eram especificados com uma cadeia de texto com aspas duplas e, se estivessem ligados a uma origem de dados também precisavam de ser nomes lógicos. Por exemplo, foi utilizado o nome lógico "cr43e_name" com aspas em vez do nome a apresentar Nome sem aspas. Para as origens de dados do SharePoint e do Excel que contêm nomes de colunas com espaços, cada espaço foi especificado com "_x0020_", por exemplo, "Nome da Coluna" como "Column_x0020_Name". Após esta versão, todas as aplicações foram atualizadas automaticamente para a nova sintaxe descrita neste artigo.
Exemplos
Os exemplos desta secção utilizam esta origem de dados, denominada IceCream:
A origem de dados também forneceu estas informações:
- O nome a apresentar para Quantidade é "Quantidade na mão".
- O comprimento máximo de Sabor é de 30 carateres.
- A coluna Sabor tem de conter um valor. A coluna Quantidade não é necessária.
- A Quantidade mínima é 0.
- A Quantidade máxima é 100.
- O utilizador atual pode ler e editar registos da origem de dados IceCream, mas não pode criar ou eliminar registos.
| Fórmula | Descrição | Resultado |
|---|---|---|
| DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Quantidade ) | Devolve o nome a apresentar para a coluna Quantidade da origem de dados IceCream. | "Quantidade Em Stock" |
| DataSourceInfo( Sorvete, DataSourceInfo.MaxLength, Sabor ) | Devolve o comprimento máximo da cadeia para a coluna Sabor da origem de dados IceCream. | 30 |
| DataSourceInfo( Sorvete, DataSourceInfo.Required, Sabor ) | A coluna Sabor da origem de dados IceCream é necessária? | verdadeiro |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Quantidade ) | A coluna Quantidade da origem de dados IceCream é necessária? | falso |
| DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Quantidade ) | Devolve o valor numérico máximo para a coluna Quantidade da origem de dados IceCream. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, Quantidade ) | Devolve o valor numérico mínimo para a coluna Quantidade da origem de dados IceCream. | 0 |
| DataSourceInfo( Sorvete, DataSourceInfo.ReadPermission) | O utilizador atual pode ler registos na origem de dados IceCream? | verdadeiro |
| DataSourceInfo( Sorvete, DataSourceInfo.EditPermission) | O utilizador atual pode editar registos na origem de dados IceCream? | verdadeiro |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | O utilizador atual pode criar registos na origem de dados IceCream? | falso |
| DataSourceInfo( Sorvete, DataSourceInfo.DeletePermission) | O utilizador atual pode eliminar registos na origem de dados Gelado? | falso |