TPHQuery - Histórico de revisão

Endrio.korb: /* Propriedades */

2026-08-17T18:25:22Z

‎Propriedades

Admin: /* Propriedades */

2026-08-17T16:56:49Z

‎Propriedades

Admin: /* Propriedades */

2026-08-17T16:56:35Z

‎Propriedades

Admin: /* Procedimentos */

2026-08-17T16:55:28Z

‎Procedimentos

Admin: /* Procedimentos */

2026-08-17T16:55:17Z

‎Procedimentos

Endrio.korb: /* Procedimentos */

2025-07-24T12:05:54Z

‎Procedimentos

Endrio.korb: /* Exemplo */

2025-07-24T11:52:58Z

‎Exemplo

Endrio.korb: /* Propriedades */

2025-07-24T11:52:33Z

‎Propriedades

Endrio.korb: /* Procedimentos */

2025-07-24T11:49:20Z

‎Procedimentos

Endrio.korb: Criou página com '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...'

2025-07-24T11:28:41Z

Criou página com '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...'

Página nova

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===
{| class="wikitable" style="width: 100%"
! 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;

@@ Linha 26: / Linha 26: @@
 |RowsAffected
 |Inteiro
-|Quantidade de registros alterado após a execução do comando
+|Quantidade de registros alterados após a execução do comando
 |-
 |Vazia

@@ Linha 26: / Linha 26: @@
 |RowsAffected
 |Inteiro
-|Quantidade de registros alterado após a execução dos comandos
+|Quantidade de registros alterado após a execução do comando
 |-
 |Vazia

@@ Linha 49: / Linha 49: @@
 *'''Prior:''' Move o cursor para o registro anterior.
 *'''Salvar:''' Salvar o registro respeitando as regras definidas na classe de negócio.
 ===Exemplo===

@@ Linha 49: / Linha 49: @@
 *'''Prior:''' Move o cursor para o registro anterior.
 *'''Salvar:''' Salvar o registro respeitando as regras definidas na classe de negócio.
 ===Exemplo===

@@ Linha 39: / Linha 39: @@
 *'''First:''' Move o cursor para o primeiro registro.
 *'''Free:''' Libera a memória ocupada pelo objeto.
-*'''Insert: ''' Insere um novo registro no dataset(modo edicação).
+*'''Insert: ''' Nativos da Query, não fazem referência direta às classes de negócio. Por isso, não é recomendado utilizá-lo, exceto quando estamos trabalhando diretamente com a Query.
 *'''Last:''' Move o cursor para o último registro.
 *'''Next:''' Move o cursor para o próximo registro do conjunto de resultados.
-*'''NovoRegistro:''' Cria um novo registro.
+*'''NovoRegistro:''' Cria um novo registro na Query executando um comando SELECT com o novo ID. Com isso, a Query passa a conter apenas esse novo registro, ou seja, uma única linha.
 *'''Open:''' Executa a consulta SQL (geralmente SELECT) e abre o conjunto de registros para leitura.
 *'''ParamByName(String):''' Atribui o parâmetro a query.
-*'''Post:''' Salva as alteraões feitas no registro atual.
+*'''Post:''' Nativos da Query, não fazem referência direta às classes de negócio. Por isso, não é recomendado utilizá-lo, exceto quando estamos trabalhando diretamente com a Query.
 *'''Prior:''' Move o cursor para o registro anterior.
-*'''Salvar:''' Salva as alterações pendentes.
+*'''Salvar:''' Salvar o registro respeitando as regras definidas na classe de negócio.
 ===Exemplo===

@@ Linha 22: / Linha 22: @@
 |Objeto
 |Retorna a quantidade total de registros obtidos pela consulta
 |-
 |Vazia

@@ Linha 53: / Linha 53: @@
    procedure EnviarEmail;
    var
-     Consulta:TPHQuery;
+     Q:TPHQuery;
    begin
-     Consulta:= NewPHQuery;
+     Q:= NewPHQuery;
      try
        Q.Add('SELECT NOME '+
@@ Linha 64: / Linha 64: @@
        Informacao(Q.FieldByName('NOME').AsString;
      finally
-       Consulta.Free;
+       Q.Free;
      end;
    end;

@@ Linha 6: / Linha 6: @@
 !Tipo
 !Descrição
 |-
 |RecNo
@@ Linha 14: / Linha 22: @@
 |Objeto
 |Retorna a quantidade total de registros obtidos pela consulta
 |-
 |Vazia