CDaoRecordset::GetFieldValue

Artigo
02/25/2013

Chamar 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 cadeia de caracteres que contém o nome de um campo.
varValue
Uma referência a um objeto de COleVariant que armazena o valor de um campo.
nIndex
Um índice com base zero do campo da coleção fields do conjunto de registros, para pesquisa pelo índice.

Valor de retorno

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

Comentários

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

Observação
É mais eficiente chamar uma das versões de essa função de membro que utiliza uma referência de objeto de COleVariant como um parâmetro, em vez de chamar uma versão que retorna um objeto de COleVariant .As últimas versões de essa função são mantidas para compatibilidade com versões anteriores.

Use GetFieldValue e SetFieldValue para associar dinamicamente em tempo de execução campos em vez de estaticamente colunas de associação usando o mecanismo de DoFieldExchange .

GetFieldValue e o mecanismo de DoFieldExchange podem ser combinados para melhorar o desempenho.Por exemplo, use GetFieldValue para recuperar um valor que você precisa apenas sob demanda, e atribuir a chamada de um botão “a” mais informações na interface.

Para informações relacionadas, consulte os tópicos “object campo” e “classifique a propriedade” na ajuda de DAO.