TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 1

changes.mady.by.user admin

Gravado em

comparado com

Nova versão 2

changes.mady.by.user Adriana Panseri Santos

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Portuguese

Pagetitle
DBInfo
DBInfo

Função: DBInfo

Obtêm informações sobre a tabela corrente.

Sintaxe

DBInfo ( < nInfoTipo> ) --> xRet

Parâmetros/Elementos
NomeTipoDescriçãoObrigatórioReferência
nInfoTipoNuméricoIndica o tipo de informação que será verificada. Para mais informações, consulte a área Observações. X
Retorno
    xRet(qualquer)
  • Retorna a informação da tabela, ou seja, a informação requisitada pelo usuário (O tipo depende da informação requisitada). Caso não tenha tabela corrente, o retorno será nulo.
Observações

O tipo de informação, do parâmetro <nInfoTipo>, é escolhido de acordo com as seguintes constantes:

ConstanteDescrição
DBI_GetRecSize

Indica o tamanho do registro em número de bytes. Similar a função RecSize(). Tipo: Númerico.

DBI_TableExt 

Indica a extensão do arquivo da tabela corrente. Tipo: Caracter.

DBI_FullPath

Indica o nome da tabela corrente com o caminho completo. Tipo: Caracter. 

DBI_BOFVerifica se está posicionada no início da tabela. Similar a função BOF(). Tipo: Lógico.

DBI_EOF 

Verifica se está posicionada no final da tabela. Similar a função EOF(). Tipo: Lógico.
DBI_Found

Verifica se a tabela está posicionada após uma pesquisa. Similar a função Found(). Tipo: Lógico.

DBI_FCount 

Indica o número de campos na estrutura da tabela corrente. Similar a função FCount(). Tipo: Numérico.
DBI_AliasIndica o nome do Alias da área de trabalho corrente. Similar a função Alias(). Tipo: Caracter.
DBI_LastUpdateVerifica a data da última alteração. Similar a função LUpdate(). Tipo: Data.
DBI_SharedRetorna, verdadeiro (.T.), se a tabela atual está aberta em modo de compartilhado; caso contrário, falso (.F.). Tipo: Lógico.

DBI_DBFilter

Retorna uma string contendo a expressão de filtro em uso, da mesma forma que a função DBFilter(). Tipo: Caracter.
DBI_ISDBFRetorna, falso (.F.), se o alias atual foi aberto a partir de uma query. Para as demais, retorna verdadeiro (.T.). Tipo: Lógico.
DBI_CANPUTREC Retorna, falso (.F.), se a tabela for aberta com Read Only, ou seja, uma query (onde não é possível inserir registros); caso contrário, verdadeiro (.T.). Tipo: Lógico.

DBI_GetLockArray

Retorna um array de registros bloqueados, da mesma forma que a função DBRLockList().

DBI_ISFLock

Retorna, verdadeiro (.T.), se o arquivo atual está bloqueado para atualizações utilizando a função FLock(); caso contrário, falso (.F.). Tipo: Lógico.

 

Exemplos 
//Este exemplo, apresenta como utilizar a função DBInfo() para obter as informações da tabela corrente.//Exemplo: Tabela de clientesUSE Clientes NEWDBInfo(DBI_FULLPATH) // Retorno: C:\Teste\Clientes.dbfDBInfo(DBI_FCOUNT) // Retorno: 12DBGoTop()DBInfo(DBI_BOF) // Retorno: .F.DBSkip(-1)DBInfo(DBI_BOF) // Retorno: .T.
Abrangência
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server