Função DataSourceInfo

Aplica-se a: Aplicações de tela Aplicações condicionadas 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 nenhuma informação. 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 Listas Microsoft.

Descrição

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 devolve true se não conseguir determinar se o utilizador 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, Informações, ColumnName )

  • DataSource – Obrigatório. A origem de dados a utilizar.

  • Informações – Necessário. O tipo de informações que pretende obter.

  • ColumnName – Opcional. Para obter informações ao nível da coluna, o nome da coluna como uma cadeia. A coluna Telefone foi transferida para "Telefone", incluindo as aspas. Para obter informações ao nível da origem de dados, o argumento ColumnName não pode ser utilizado.

    Nota

    Para origens de dados do SharePoint e do Excel que contêm nomes de coluna com espaços, especifique cada espaço como "_x0020_". Por exemplo, especifique "Nome da Coluna" como "Column_x0020_Name".

Exemplos

Os exemplos desta secção utilizam esta origem de dados, denominada IceCream:

Exemplo de 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( IceCream, DataSourceInfo.MaxLength, "Sabor" ) Devolve o comprimento máximo da cadeia para a coluna Sabor da origem de dados IceCream. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, "Sabor" ) A coluna Sabor da origem de dados IceCream é necessária? true
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantidade" ) A coluna Quantidade da origem de dados IceCream é necessária? false
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( IceCream, DataSourceInfo.ReadPermission) O utilizador atual pode ler registos na origem de dados IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) O utilizador atual pode editar registos na origem de dados IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) O utilizador atual pode criar registos na origem de dados IceCream? false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) O utilizador atual pode eliminar registos na origem de dados Gelado? false