Conjunto de registros: parametrizando um conjunto de registros (ODBC)

Este tópico aplica-se às classes ODBC do MFC.

Às vezes, talvez convenha poder selecionar registros em tempo de execução usando informações que você calculou ou obteve de seu usuário final. Os parâmetros de conjunto de registros permitem que você atinja essa meta.

Este tópico explica:

• A finalidade de um conjunto de registros com parâmetros.

• Quando e por que talvez convenha parametrizar um conjunto de registros.

• Como declarar membros de dados de parâmetro em sua classe de conjunto de registros.

• Como passar informações de parâmetro para um objeto de conjunto de registros em tempo de execução.

Conjuntos de registros parametrizados

Um conjunto de registros com parâmetros permite que você passe informações em tempo de execução. Ele tem dois efeitos valiosos:

• Pode resultar em uma melhor velocidade de execução.

• Permite que você crie uma consulta em tempo de execução, com base em informações não disponíveis para você em tempo de design, como informações obtidas do seu usuário ou calculadas em tempo de execução.

Quando você chama Open para executar a consulta, o conjunto de registros usa as informações de parâmetro para concluir sua instrução SELECT SQL. É possível parametrizar qualquer conjunto de registros.

Quando usar parâmetros

Os usos típicos de parâmetros incluem:

• Passar argumentos de tempo de execução para uma consulta predefinida.

  Para passar parâmetros para um procedimento armazenado, é necessário especificar uma instrução CALL ODBC completa e personalizada – com espaços reservados de parâmetro – quando você chama Open, substituindo a instrução SQL padrão do conjunto de registros. Para obter mais informações, confira CRecordset::Open na Referência de Biblioteca de Classes e SQL: personalizando a instrução SQL do seu conjunto de registros (ODBC) e Conjunto de registros: declarando uma classe para uma consulta predefinida (ODBC).

• Executar com eficiência inúmeras repetições de consulta com diferentes informações de parâmetro.

  Por exemplo, cada vez que seu usuário final pesquisa informações para um aluno específico no banco de dados de registro de aluno, você pode especificar o nome ou a ID do aluno como um parâmetro obtido do usuário. Em seguida, quando você chama a função de membro Requery do seu conjunto de registros, a consulta seleciona apenas o registro desse aluno.

  As cadeias de caracteres de filtro do conjunto de registros, armazenadas em m_strFilter, podem ter esta aparência:

  "StudentID = ?"
  

  Suponha que você obtenha a ID do aluno na variável strInputID. Quando você define um parâmetro como strInputID (por exemplo, a ID 100 do aluno), o valor da variável está associado ao espaço reservado do parâmetro representado pelo “?” na cadeia de caracteres de filtro.

  Atribua o valor de parâmetro da seguinte maneira:

  strInputID = "100";
  ...
  m_strParam = strInputID;
  

  Não conviria configurar uma cadeia de caracteres de filtro desta maneira:

  m_strFilter = "StudentID = 100";   // 100 is incorrectly quoted
                                     // for some drivers
  

  Para ver uma discussão sobre como usar cotações corretamente para cadeias de caracteres de filtro, confira Conjunto de registros: filtrando registros (ODBC).

  O valor do parâmetro é diferente a cada vez que você repete a consulta do conjunto de registros para uma nova ID de aluno.

  Dica

  Usar um parâmetro é mais eficiente do que simplesmente um filtro. Para ver um conjunto de registros com parâmetros, o banco de dados deve processar uma instrução SELECT SQL somente uma vez. Para um conjunto de registros filtrado sem parâmetros, a instrução SELECT deve ser processada cada vez que você Requery com um novo valor de filtro.

Para saber mais sobre filtros, confira Conjunto de registros: Filtrando registros (ODBC).

Parametrizando sua classe Recordset

Antes de criar sua classe de conjunto de registros, determine quais parâmetros são necessários, quais são seus tipos de dados e como o conjunto de registros os usa.

Para parametrizar uma classe de conjunto de registros

1. Execute o Assistente de consumidor ODBC MFC de Adicionar Classe para criar a classe.

2. Especifique membros de dados de campo para as colunas do conjunto de registros.

3. Depois que o assistente escrever a classe em um arquivo em seu projeto, acesse o arquivo .h e adicione manualmente um ou mais membros de dados de parâmetro à declaração de classe. A adição pode ter uma aparência semelhante à do exemplo a seguir, parte de uma classe de instantâneo criada para responder à consulta “Quais alunos estão na classe sênior?”

   class CStudentSet : public CRecordset
   {
   // Field/Param Data
       CString m_strFirstName;
       CString m_strLastName;
       CString m_strStudentID;
       CString m_strGradYear;
   
       CString m_strGradYrParam;
   };
   

   Adicione seus membros de dados de parâmetro após os membros de dados de campo gerados pelo assistente. A convenção é acrescentar a palavra “Param” a cada nome de parâmetro definido pelo usuário.

4. Modifique a definição de função de membro DoFieldExchange no arquivo .cpp. Adicione uma chamada de função RFX para cada membro de dados de parâmetro adicionado à classe. Para saber mais sobre como escrever suas funções RFX, confira Troca de campos de registro: como a RFX funciona. Preceda as chamadas RFX para os parâmetros com uma única chamada para:

   pFX->SetFieldType( CFieldExchange::param );
   // RFX calls for parameter data members
   

5. No construtor de sua classe de conjunto de registros, incremente a contagem de parâmetros, m_nParams.

   Para obter informações, confira Troca de campo de registro: trabalhando com o código do assistente.

6. Ao escrever o código que cria um objeto de conjunto de registros dessa classe, insira um símbolo “?” (ponto de interrogação) em cada local em suas cadeias de caracteres de instrução SQL em que um parâmetro deve ser substituído.

   Em tempo de execução, os espaços reservados “?” são preenchidos, em ordem, pelos valores de parâmetro passados. O primeiro membro de dados de parâmetro definido após a chamada SetFieldType substitui o primeiro "?"na cadeia de caracteres SQL, o segundo membro de dados de parâmetro substitui o segundo"?" e assim por diante.

Passando valores de parâmetro em tempo de execução

É necessário especificar valores de parâmetro antes de chamar Open (para um novo objeto de conjunto de registros) ou Requery (para um existente).

Para passar valores de parâmetro para um objeto de conjunto de registros em tempo de execução

1. Construa o objeto de conjunto de registros.

2. Prepare uma cadeia ou cadeias de caracteres, como a cadeia de caracteres m_strFilter que contém a instrução SQL ou partes dela. Coloque os espaços reservados "?" onde as informações de parâmetro devem ir.

3. Atribua um valor de parâmetro de tempo de execução a cada membro de dados de parâmetro do objeto.

4. Chame a função de membro Open (ou Requery, para um conjunto de registros existente).

Por exemplo, suponha que você quer especificar uma cadeia de caracteres de filtro para seu conjunto de registros que usa informações obtidas em tempo de execução. Suponha que você construiu um conjunto de registros da classe CStudentSet anteriormente — chamado rsStudents — e agora deseja repetir a consulta dele para um tipo específico de informações dos alunos.

// Set up a filter string with
// parameter placeholders
rsStudents.m_strFilter = "GradYear <= ?";

// Obtain or calculate parameter values
// to pass--simply assigned here
CString strGradYear = GetCurrentAcademicYear( );

// Assign the values to parameter data members
rsStudents.m_strGradYrParam = strGradYear;

// Run the query
if( !rsStudents.Requery( ) )
    return FALSE;

O conjunto de registros contém registros para os alunos cujos registros atendem às condições especificadas pelo filtro, que foi construído com base em parâmetros de tempo de execução. Nesse caso, o conjunto de registros contém registros para todos os alunos seniores.

Confira também

Conjunto de registros (ODBC)
Conjunto de registros: adicionando, atualizando e excluindo registros (ODBC)
Conjunto de registros: como conjuntos de registros selecionam registros (ODBC)