Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Composition Setup
import.css=/download/attachments/3279126062824/newLayouttecnologia.css
Portuguese

Pagetitle
DBInfo

...

...

...

DBInfo

Obtêm

...

informações

...

sobre

...

a

...

tabela

...

corrente.

Sintaxe

Bloco de código
collapsefalse
DBInfo( <
nInfoTipo> ) --> xRet
 nInfo > )

Parâmetros

...

Nome

Tipo

Descrição

Obrigatório

Referência

...

nInfo

...

numérico

Indica o tipo de informação que será verificada. Para mais informações, consulte a área Observações.

X

 

Retorno

...

Nome

Tipo

Descrição

xInfo

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

...

  • <nInfo>, é escolhido de acordo com as seguintes constantes:

Constante

Descrição

DBI_

...

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

...

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_

...

Alias

Indica o nome do Alias da área de trabalho corrente. Similar a função

...

Alias(). Tipo:

...

Caracter.

DBI_

...

FCount

Indica o número de campos na estrutura da tabela corrente

...

. Similar a função

...

FCount(). Tipo:

...

Numérico.

DBI_

...

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

...

DBI_FCount 

GetRecSize

Indica o tamanho do registro em número de bytes

...

. Similar a função

...

RecSize(). Tipo:

...

Númerico.

DBI_

...

GetLockArray

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

DBI_

...

DBFilter

Retorna uma string contendo a expressão de filtro em uso, da mesma forma que a função DBFilter(). Tipo:

...

Caracter.

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_DBFilter

...

.

...

DBI_ISDBF

Retorna, falso (.F.), se o alias atual foi aberto a partir de uma query. Para as demais, retorna verdadeiro (.T.). Tipo: Lógico.

DBI_

...

Shared

...

Retorna,

...

verdadeiro (.

...

T.), se a tabela

...

atual está aberta em modo de compartilhado; caso contrário,

...

falso (.

...

F.). Tipo: Lógico

...

DBI_GetLockArray

...

.

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.

DBI_LastUpdate

Verifica a data da última alteração. Similar a função LUpdate(). Tipo: Data.

DBI_Found

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

DBI_EOF

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

...

 

//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. 

...

DBI_BOF

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

Exemplos

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
USER FUNCTION TEST()
  TCLink()
  
  DBCreate("T1", {{"FIELD_NAME", "C", 10, 0}, ;
                  {"FIELD_TYPE", "C", 10, 0}}, "TOPCONN")

  
  DBUseArea(.F., 'TOPCONN', cT1, (cT1), .F., .F.)

  conout(DBInfo(33 /*DBI_Alias*/))
  
  DBCloseArea()
  TCUnlink()
RETURN

Veja também