conjunto de registros: Arquitetura (ODBC)

Artigo
08/25/2010

Este tópico se aplica a classes MFC ODBC.

Este tópico descreve os membros de dados que constituem a arquitetura de um objeto conjunto de registros:

Membros de dados de campo
Membros de dados de parâmetro
Usando membros de dados m_nFields e m_nParams

Observação:
Este tópico se aplica aos objetos derivados CRecordset em qual linha em massa a busca não foi implementada. Se buscar em massa a linha for implementada, a arquitetura é semelhante.Para entender as diferenças, consulte conjunto de registros: Buscando os registros em massa (ODBC).

Classe de exemplo

Quando você usa o Assistente de consumidor ODBC do MFC from Adicionar classe Assistente para declarar uma classe de conjunto de registros é derivado de CRecordset, a classe resultante tem a estrutura geral mostra a seguinte classe simples:

class CCourse : public CRecordset
{
public:
   CCourse(CDatabase* pDatabase = NULL);
   ...
   CString m_strCourseID;
   CString m_strCourseTitle;
   CString m_strIDParam;
};

No início da classe, o assistente grava um conjunto de membros de campo de dados.Quando você cria a classe, você deve especificar um ou mais membros de dados do campo.Se a classe parametrizada, sistema autônomo o exemplo de classe será (com o membro de dados m_strIDParam), você deve adicionar manualmente membros de dados de parâmetro.O assistente não oferece suporte adicionando parâmetros a uma classe.

Membros de dados de campo

Os membros mais importantes da sua classe de conjunto de registros são os membros de dados do campo.Para cada coluna selecionada da fonte de dados, a classe contém um membro de dados do tipo de dados apropriado para aquela coluna.Por exemplo, a classe de exemplo mostrado no início deste tópico tem dois membros de dados de campo, ambos do tipo CString, chamado m_strCourseID e m_strCourseTitle.

Quando o conjunto de registros seleciona um conjunto de registros, a estrutura vincula automaticamente as colunas da registro corrente (após o em aberto telefonar, o primeiro registro é o corrente) para campo dados membros do objeto.Ou seja, a estrutura usa o membro de dados do campo apropriado sistema autônomo um buffer para armazenar o Sumário de uma coluna de registro.

Conforme o usuário rola para um novo registro, a estrutura usa sistema autônomo membros de dados do campo para representar o registro corrente.A estrutura atualiza os membros de dados de campo, substituindo valores do registro anterior.Os membros de dados do campo também são usados para atualizar o registro corrente e para adicionar novos registros.sistema autônomo parte do processo de atualização um registro, você pode especificar sistema autônomo valores de atualização atribuindo valores diretamente para o membro de dados do campo apropriado ou membros.

Membros de dados de parâmetro

Se a classe parametrizada, ele tem um ou mais membros de dados de parâmetro.Uma classe com parâmetros permite basear uma consulta de conjunto de registros em informações obtidas ou calculado em time de execução.

Normalmente, o parâmetro ajuda a restringir a seleção, sistema autônomo no exemplo a seguir.Baseia o classe de exemplo no início deste tópico, o objeto de conjunto de registros pode executar a seguinte demonstrativo SQL:

SELECT CourseID, CourseTitle FROM Course WHERE CourseID = ?

O "?" é um espaço reservado para um valor de parâmetro que você fornecer em time de execução.Quando você construir o conjunto de registros e defina sua m_strIDParam membro de dados para MATH101, se torna a demonstrativo SQL efetivo para o conjunto de registros:

SELECT CourseID, CourseTitle FROM Course WHERE CourseID = MATH101

Definindo o parâmetro membros de dados, você pode dizer a estrutura sobre os parâmetros na seqüência de caracteres SQL.A estrutura vincula o parâmetro, que permite que o ODBC saber onde obter valores para substituir o espaço reservado.No exemplo, o conjunto de registros resultante contém somente o registro da tabela com uma coluna CourseID cujo valor é MATH101 curso.Todas as colunas especificadas desse registro são selecionadas.Você pode especificar quantos parâmetros (e espaços reservados) conforme necessário.

Observação:
MFC não faz nada propriamente dito com os parâmetros — em Especificamente, Ele não realiza uma substituição de texto.Em vez disso, o MFC informa ao ODBC onde obter o parâmetro; ODBC recupera os dados e executa a parametrização necessária.

Observação:
A ordem dos parâmetros é importante.Para obter mais informações sobre os parâmetros e informações sobre este assunto, consulte conjunto de registros: Parametrização um conjunto de registros (ODBC).

Usando m_nFields e m_nParams

Quando um assistente grava um construtor para sua classe, também inicializa o m_nFields membro de dados, que especifica o número de membros de campo de dados na classe.Se você adicionar qualquer parâmetros à sua classe, você deve adicionar também uma inicialização para o m_nParams dados membro, que especifica o número de membros de dados do parâmetro.A estrutura usa esses valores para trabalhar com os membros de dados.

Para obter mais informações e exemplos, consulte Intercâmbio de campo do registro: Usando RFX.

Consulte também

Conceitos

conjunto de registros (ODBC)

conjunto de registros: Declarar uma classe para uma tabela (ODBC)

Registro de campo Exchange (RFX)

Compartilhar via