Fornece informações sobre uma fonte de dados.

Visão geral

Fontes de dados podem fornecer uma infinidade de informações para otimizar a experiência do usuário.

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. A função validar usa essas mesmas informações.

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.

O volume de informações fornecidas pelas fontes de dados varia, incluindo não fornecer informação alguma. Coleções não fornecem informações. Se parte das informações não for fornecida, serão usadas as opções padrão, ou retornará em branco.

Descrição

Informações de coluna

Você pode usar o DataSourceInfo para obter informações sobre uma determinada coluna de uma fonte de dados:

Argumento de informações Tipo de resultado Descrição
DataSourceInfo.DisplayName Cadeia de caracteres Nome de exibição para a coluna. Se nenhum nome de exibição for definido, retornará o nome da coluna.
DataSourceInfo.MaxLength Número Número máximo de caracteres que a coluna pode conter. Aplica-se somente às colunas que contenham cadeias de caracteres. Se um máximo não for definido, retornará em branco.
DataSourceInfo.MaxValue Número Valor numérico máximo que uma coluna pode conter. Aplica-se somente às colunas que contêm números. Se um máximo não for definido, retornará em branco.
DataSourceInfo.MinValue Número Valor numérico mínimo que uma coluna pode conter. Aplica-se somente às colunas que contêm números. Se um mínimo não for definido, retornará em branco.
DataSourceInfo.Required Booleano Essa coluna exige um valor específico? Se não for definido pela fonte de dados, retornará como falso.

O terceiro argumento é o nome de uma coluna como uma cadeia de caracteres. Por exemplo, a coluna Telefone na coleção Pessoas seria nomeada como "Telefone" com aspas duplas.

Informações da fonte de dados

Você também pode usar o DataSourceInfo para obter informações sobre uma fonte de dados como um todo:

Argumento de informações Tipo de resultado Descrição
DataSourceInfo.AllowedValues Booleano Quais tipos de permissões podem ser concedidos aos usuários nessa fonte de dados? Se isso não for definido pela fonte de dados, retornará blank.
DataSourceInfo.CreatePermission Booleano O usuário atual tem permissão para criar registros nessa fonte de dados? Se não definida pela fonte de dados, retornará como verdadeiro.
DataSourceInfo.DeletePermission Booleano O usuário atual tem permissão para excluir registros nessa fonte de dados? Se não definida pela fonte de dados, retornará como verdadeiro.
DataSourceInfo.EditPermission Booleano O usuário atual tem permissão para editar os registros nessa fonte de dados? Se não definida pela fonte de dados, retornará como verdadeiro.
DataSourceInfo.ReadPermission Booleano O usuário atual tem permissão para ler registros nessa fonte de dados? Se não definida pela fonte de dados, retornará como verdadeiro.

Sintaxe

DataSourceInfo( DataSource, Informações, ColumnName )

  • DataSource – obrigatório. A fonte de dados a ser usada.
  • Informações – obrigatório. O tipo de informações que você deseja recuperar.
  • ColumnName – opcional. Para informações de nível de coluna, o nome da coluna como uma cadeia de caracteres. A coluna Telefone seria nomeada como "Telefone" com aspas duplas. Para obter informações no nível de fonte de dados, o argumento ColumnName não pode ser usado.

    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_". Por exemplo, especifique "Nome da Coluna" como "Nome_x0020_da_x0020_Coluna".

Exemplos

Os exemplos nesta seção usam essa fonte de dados, chamada Sorvete:

A fonte de dados também fornece essas informações:

  • O nome de exibição em Quantidade é "Quantidade disponível".
  • O comprimento máximo de Sabor é de 30 caracteres.
  • A coluna Sabor deve conter um valor. A coluna Quantidade não é necessária.
  • O valor mínimo para Quantidade é 0.
  • O valor máximo para Quantidade é 100.
  • O usuário atual pode ler e editar os registros da fonte de dados Sorvete, mas não pode criar nem excluir registros.
Fórmula Descrição Resultado
DataSourceInfo( Sorvete, DataSourceInfo.DisplayName, "Quantidade" ) Retorna o nome de exibição da coluna Quantidade da fonte de dados Sorvete. "Quantidade disponível"
DataSourceInfo( Sorvete, DataSourceInfo.MaxLength, "Sabor" ) Retorna o comprimento máximo da cadeia de caracteres da coluna Sabor da fonte de dados Sorvete. 30
DataSourceInfo ( Sorvete, DataSourceInfo.Required, "Sabor" ) A coluna Sabor da fonte de dados Sorvete é necessária? verdadeiro
DataSourceInfo ( Sorvete, DataSourceInfo.Required, "Quantidade" ) A coluna Quantidade da fonte de dados Sorvete é necessária? falso
DataSourceInfo ( Sorvete, DataSourceInfo.MaxValue, "Quantidade" ) Retorna o valor numérico máximo para a coluna Quantidade da fonte de dados Sorvete. 100
DataSourceInfo ( Sorvete, DataSourceInfo.MinValue, "Quantidade" ) Retorna o menor valor numérico para a coluna Quantidade da fonte de dados Sorvete. 0
DataSourceInfo ( Sorvete, DataSourceInfo.ReadPermission) O usuário atual tem permissão para ler registros da fonte de dados Sorvete? verdadeiro
DataSourceInfo ( Sorvete, DataSourceInfo.EditPermission) O usuário atual tem permissão para editar registros na fonte de dados Sorvete? verdadeiro
DataSourceInfo ( Sorvete, DataSourceInfo.CreatePermission) O usuário atual tem permissão para criar registros na fonte de dados Sorvete? falso
DataSourceInfo ( Sorvete, DataSourceInfo.DeletePermission) O usuário atual tem permissão para excluir registros da fonte de dados Sorvete? falso