PHSYS - Wiki

O objeto TPHQuery permite executar comandos SQL (consulta, inserção, atualização ou exclusão) e manipular os dados retornados. Ele funciona como um cursor que percorre os registros do banco de dados.

Propriedades

Nome	Tipo	Descrição
RecNo	Inteiro	Indica a posição atual do registro no conjunto de resultados
RecordCount	Objeto	Retorna a quantidade total de registros obtidos pela consulta
Eof	Booleano	Indica se o cursor atingiu o fim do conjunto de registros
Vazia	Booleano	Indica se a consulta não retornou nenhum registro

Procedimentos

• Open: Executa a consulta SQL (geralmente SELECT) e abre o conjunto de registros para leitura.
• Close: Fecha o conjunto de resultados da consulta.
• Next: Move o cursor para o próximo registro do conjunto de resultados.
• First: Move o cursor para o primeiro registro.
• Last: Move o cursor para o último registro.
• Add: Adiciona linha de comando SQL ao objeto.
• FieldByName('Campo'): Retorna o valor do campo especificado da linha atual.
• ExecSQL: Executa um comando SQL que não retorna registros (INSERT, UPDATE, DELETE).

Exemplo

 procedure EnviarEmail;
 var
   Consulta:TPHQuery;                                           
 begin
   Consulta:= NewPHQuery;
   try
     Q.Add('SELECT NOME '+
           'FROM MUNICIPIOS '+
           'WHERE ID = 1');
     Q.Open;
                         
     Informacao(Q.FieldByName('NOME').AsString;               
   finally
     Consulta.Free;                                        
   end;            
 end;