CDaoRecordset::GetFieldValue

Artigo
08/25/2010

Chame essa função de membro para recuperar dados em um conjunto de registros.

virtual void GetFieldValue(
   LPCTSTR lpszName,
   COleVariant& varValue 
);
virtual void GetFieldValue(
   int nIndex,
   COleVariant& varValue 
);
virtual COleVariant GetFieldValue(
   LPCTSTR lpszName 
);
virtual COleVariant GetFieldValue(
   int nIndex 
);

Parâmetros

lpszName
Um ponteiro para uma seqüência de caracteres que contém o nome de um campo.
varValue
Uma referência a um COleVariant objeto que armazenará o valor de um campo.
nIndex
Um índice baseado em zero do campo na coleção Fields do conjunto de registros, para a pesquisa por índice.

Valor de retorno

As duas versões de GetFieldValue que retornam um valor de retorno um COleVariant objeto que contém o valor de um campo.

Comentários

Você pode pesquisar um campo por nome ou pela posição ordinal.

Observação:
É mais eficiente para telefonar de uma das versões desta função de membro que leva uma COleVariant referência de objeto sistema autônomo um parâmetro, em vez de chamar uma versão que retorna um COleVariant objeto. Versões dessa função último são mantidas para compatibilidade com versões anteriores.

Use GetFieldValue e SetFieldValue BIND campos dinamicamente no time de execução em vez de ligação estaticamente colunas usando o DoFieldExchange mecanismo.

GetFieldValue e o DoFieldExchange mecanismo pode ser combinado para melhorar o desempenho. Por exemplo, use GetFieldValuepara recuperar um valor que você precisa apenas sob demanda e atribuir a telefonar a um botão "Mais informações" na interface do.

Para obter informações relacionadas, consulte os tópicos "Campo objeto" e "Propriedade de valor" na Ajuda do DAO.