Estrutura CDaoQueryDefInfo

A estrutura CDaoQueryDefInfo contém informações sobre um objeto querydef definido para DAOs (objetos de acesso a dados).

Sintaxe

struct CDaoQueryDefInfo
{
    CString m_strName;               // Primary
    short m_nType;   // Primary
    COleDateTime m_dateCreated;      // Secondary
    COleDateTime m_dateLastUpdated;  // Secondary
    BOOL m_bUpdatable;               // Secondary
    BOOL m_bReturnsRecords;          // Secondary
    CString m_strSQL;                // All
    CString m_strConnect;            // All
    short m_nODBCTimeout;            // All
};

Parâmetros

m_strName
Nomeia exclusivamente o objeto querydef. Para obter mais informações, confira o tópico "Propriedade Name" na Ajuda do DAO. Chame CDaoQueryDef::GetName para recuperar essa propriedade diretamente.

m_nType
Um valor que indica o tipo operacional de um objeto querydef. O valor pode ser um dos seguintes:

• dbQSelect Selecionar – a consulta seleciona registros.

• dbQAction Ação – a consulta move ou altera dados, mas não retorna registros.

• dbQCrosstab Guia cruzada – a consulta retorna dados em um formato semelhante a uma planilha.

• dbQDelete Excluir – a consulta exclui um conjunto de linhas especificadas.

• dbQUpdate Atualizar – a consulta altera um conjunto de registros.

• dbQAppend Acrescentar – a consulta adiciona novos registros ao final de uma tabela ou consulta.

• dbQMakeTable Criar tabela – a consulta cria uma tabela com base em um conjunto de registros.

• dbQDDL Definição de dados – a consulta afeta a estrutura de tabelas ou seus blocos.

• dbQSQLPassThrough Passagem – a instrução SQL é passada diretamente para o back-end do banco de dados, sem processamento intermediário.

• dbQSetOperation União – a consulta cria um objeto de conjunto de registros do tipo instantâneo que contém dados de todos os registros especificados em duas ou mais tabelas com todos os registros duplicados removidos. Para incluir as duplicatas, adicione a palavra-chave ALL à instrução SQL de querydef.

• dbQSPTBulk Usado com dbQSQLPassThrough para especificar uma consulta que não retorna registros.

Observação

Para criar uma consulta de passagem SQL, você não define a constante dbQSQLPassThrough. Ela é definida automaticamente pelo mecanismo de banco de dados do Microsoft Jet quando você cria um objeto querydef e define a propriedade Connect.

Para mais informações, confira o tópico "Propriedade Type" na Ajuda do DAO.

m_dateCreated
A data e a hora em que querydef foi criado. Para recuperar diretamente a data em que querydef foi criado, chame a função membro GetDateCreated do objeto CDaoTableDef associado à tabela. Confira Comentários abaixo para obter mais informações. Consulte também o tópico "Propriedades DateCreated, LastUpdated" na Ajuda do DAO.

m_dateLastUpdated
A data e a hora da alteração mais recente feita em querydef. Para recuperar diretamente a data em que a tabela foi atualizada pela última vez, chame a função membro GetDateLastUpdated de querydef. Confira Comentários abaixo para obter mais informações. Consulte também o tópico "Propriedades DateCreated, LastUpdated" na Ajuda do DAO.

m_bUpdatable
Indica se é possível fazer alterações em um objeto querydef. Se essa propriedade for TRUE, querydef será atualizável; caso contrário, não será. Atualizável significa que a definição da consulta do objeto querydef pode ser alterada. A propriedade Updatable de um objeto querydef será definida como TRUE se a definição da consulta puder ser atualizada, mesmo que o conjunto de registros resultante não seja atualizável. Para recuperar essa propriedade diretamente, chame a função membro CanUpdate de querydef. Para obter mais informações, confira o tópico "Propriedade Updatable" na ajuda do DAO.

m_bReturnsRecords
Indica se uma consulta de passagem do SQL para um banco de dados externo retorna registros. Se essa propriedade for TRUE, a consulta retornará registros. Para recuperar a propriedade diretamente, chame CDaoQueryDef::GetReturnsRecords. Nem todas as consultas de passagem do SQL para bancos de dados externos retornam registros. Por exemplo, uma instrução SQL UPDATE atualiza registros sem retornar registros, enquanto uma instrução SQL SELECT retorna registros. Para obter mais informações, confira o tópico "Propriedade ReturnsRecords" na Ajuda do DAO.

m_strSQL
A instrução SQL que define a consulta executada por um objeto querydef. A propriedade SQL contém a instrução SQL que determina como os registros são selecionados, agrupados e ordenados quando você executa a consulta. Você pode usar a consulta para selecionar registros a serem incluídos em um objeto de conjunto de registros do tipo dynaset ou instantâneo. Você também pode definir consultas em massa para modificar dados sem retornar registros. Você pode recuperar o valor dessa propriedade diretamente chamando a função membro GetSQL de querydef.

m_strConnect
Fornece informações sobre a origem de um banco de dados usado em uma consulta de passagem. Essas informações assumem a forma de uma cadeia de caracteres de conexão. Para obter mais informações sobre cadeias de caracteres de conexão e sobre como recuperar o valor dessa propriedade diretamente, consulte a função membro CDaoDatabase::GetConnect.

m_nODBCTimeout
O número de segundos que o mecanismo de banco de dados do Microsoft Jet aguarda antes que ocorra um erro de tempo limite quando uma consulta é executada em um banco de dados ODBC. Quando você está usando um banco de dados ODBC, como o Microsoft SQL Server, pode haver atrasos devido ao tráfego de rede ou ao uso intenso do servidor ODBC. Em vez de aguardar indefinidamente, você pode especificar quanto tempo o mecanismo do Microsoft Jet aguarda antes de produzir um erro. O valor padrão do tempo limite é de 60 segundos. Você pode recuperar o valor dessa propriedade diretamente chamando a função membro GetODBCTimeout de querydef. Para obter mais informações, confira o tópico "Propriedade ODBCTimeout" na Ajuda do DAO.

Comentários

O querydef é um objeto da classe CDaoQueryDef. As referências a Primary, Secondary e All acima indicam como as informações são retornadas pela função membro GetQueryDefInfo na classe CDaoDatabase.

As informações recuperadas pela função membro CDaoDatabase::GetQueryDefInfo são armazenadas em uma estrutura CDaoQueryDefInfo. Chame GetQueryDefInfo para o objeto de banco de dados em cuja coleção QueryDefs o objeto querydef está armazenado. CDaoQueryDefInfo também define uma função membro Dump em builds de depuração. Você pode usar Dump para despejar o conteúdo de um objeto CDaoQueryDefInfo. A classe CDaoDatabase também fornece funções membro para acessar diretamente todas as propriedades retornadas em um objeto CDaoQueryDefInfo, portanto, provavelmente você raramente precisará chamar GetQueryDefInfo.

Quando você acrescenta um novo campo ou objeto de parâmetro à coleção de Campos ou Parâmetros de um objeto querydef, uma exceção é gerada quando o banco de dados subjacente não dá suporte ao tipo de dados especificado para o novo objeto.

As configurações de data e hora são derivadas do computador no qual querydef foi criado ou atualizado pela última vez. Em um ambiente multiusuário, os usuários devem obter essas configurações diretamente do servidor de arquivos usando o comando net time para evitar discrepâncias nas configurações de propriedade DateCreated e LastUpdated.

Requisitos

Cabeçalho: afxdao.h

Confira também

Estruturas, estilos, retornos de chamada e mapas de mensagem
Classe CDaoQueryDef
Classe CDaoDatabase