Estrutura CDaoQueryDefInfo

Artigo
08/25/2010

The CDaoQueryDefInfo estrutura contém informações sobre um objeto definiçãodeconsulta definida para objetos de acesso a dados (DAO).

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 o objeto definiçãodeconsulta exclusivamente.Para obter mais informações, consulte o tópico "Propriedade de nome" na Ajuda do DAO. De telefonarCDaoQueryDef::GetName para recuperar essa propriedade diretamente.

m_nType
Um valor que indica o tipo de um objeto definiçãodeconsulta operacional.O valor pode ser uma das seguintes opções:

dbQSelect Selecione — a consulta selecionar registros.
dbQAction Ação — a consulta move ou altera dados mas não retorna registros.
dbQCrosstab Referência cruzada — a consulta retorna dados em um formato de planilha.
dbQDelete Excluir — a consulta exclui um conjunto de linhas especificadas.
dbQUpdate Atualização — a consulta altera um conjunto de registros.
dbQAppend acrescentar — a consulta adiciona novos registros ao participante de uma tabela ou consulta.
dbQMakeTable Criar tabela, consulta cria uma nova tabela de um conjunto de registros.
dbQDDL Definição de dados — a consulta afeta a estrutura de tabelas ou de suas partes.
dbQSQLPassThrough Passagem — o demonstrativo SQL é passado diretamente para o back-end de banco de dados, sem processamento intermediário.
dbQSetOperation União — a consulta cria um objeto conjunto de registros tipo instantâneo contendo dados de especificado todos os registros em duas ou mais tabelas com quaisquer registros duplicados removidos.Para incluir as duplicatas, adicione a palavra-chave TODOS OS na definiçãodeconsulta demonstrativo SQL.
dbQSPTBulk Usado com dbQSQLPassThrough para especificar uma consulta que não retorna registros.

Observação:
Para criar uma consulta passagem SQL, você não conjunto o dbQSQLPassThrough constante.Isso é definido automaticamente pelo mecanismo de banco de dados Microsoft Jet, quando você cria um objeto definiçãodeconsulta e define a propriedade conectar.

Para obter mais informações, consulte o tópico "Propriedade de tipo" na Ajuda do DAO.

m_dateCreated
A data e time que a definiçãodeconsulta foi criada.Para recuperar diretamente a data de criação, a definiçãodeconsulta telefonar o GetDateCreated função de membro do CDaoTableDef objeto associado à tabela. Para obter mais informações, consulte comentários abaixo.Além disso, consulte o tópico "DateCreated e LastUpdated Properties" na Ajuda do DAO.
m_dateLastUpdated
A data e time da última alterar feita a definiçãodeconsulta.Para recuperar a data em que a tabela foi atualizado pela última vez, diretamente telefonar o GetDateLastUpdatedfunção de membro da definiçãodeconsulta.Para obter mais informações, consulte comentários abaixo.E consulte o tópico "DateCreated e LastUpdated Properties" na Ajuda do DAO.
m_bUpdatable
Indica se podem ser feitas alterações em um objeto definiçãodeconsulta.Se essa propriedade for TRUE, a definiçãodeconsulta é atualizável; caso contrário, não é.Updatable significa que a definição de consulta do objeto definiçãodeconsulta pode ser alterada.A propriedade atualizável de um objeto definiçãodeconsulta é definida como TRUE se a definição de consulta pode ser atualizada, mesmo que o conjunto de registros resultante não seja atualizável.Para recuperar essa propriedade diretamente, telefonar CanUpdatefunção de membro .Para obter mais informações, consulte o tópico "Propriedade atualizável" na Ajuda do DAO.
m_bReturnsRecords
Indica se uma consulta SQL pass-through a um banco de dados externo retorna registros.Se essa propriedade for TRUE, a consulta retorna registros.Para recuperar diretamente essa propriedade, chame CDaoQueryDef::GetReturnsRecords.Nem todas as consultas de passagem de SQL a bancos de dados externos retornam registros.Por exemplo, um SQL ATUALIZAÇÃO demonstrativo atualiza registros sem retornar registros, enquanto um SQL selecionar demonstrativo retornar registros.Para obter mais informações, consulte o tópico "Propriedade ReturnsRecords" na Ajuda do DAO.
m_strSQL
O demonstrativo SQL que define a consulta executada por um objeto definiçãodeconsulta.A propriedade SQL contém a demonstrativo SQL que determina como registros são selecionados, agrupados e ordenado quando você executa a consulta.Você pode usar a consulta para selecionar registros para incluir em um objeto conjunto de registros do tipo dynaset ou instantâneo.Você também pode definir consultas em massa para modificar os dados sem retornar registros.Você pode recuperar o valor desta propriedade diretamente, chamando GetSQLfunção de membro .
m_strConnect
Fornece informações sobre fonte de um banco de dados usado em uma consulta passagem.Essas informações assume a forma de uma seqüência de conectar.Para obter mais informações sobre conectar-se seqüências de caracteres e para obter informações sobre como recuperar o valor desta propriedade diretamente, consulte o CDaoDatabase::GetConnectfunção de membro .
m_nODBCTimeout
O número de segundos que o mecanismo de banco de dados Microsoft Jet aguarda antes de um erro de tempo limite ocorre quando uma consulta é executada em um banco de dados ODBC.Quando você estiver usando um banco de dados ODBC, sistema autônomo o Microsoft SQL Server, pode haver atrasos devido de uso de tráfego ou intenso de rede do servidor ODBC.Em vez de esperar indefinidamente, você pode especificar quanto tempo o mecanismo Microsoft Jet espera antes que ele produz um erro.O valor de tempo limite padrão é de 60 segundos.Você pode recuperar o valor desta propriedade diretamente, chamando GetODBCTimeoutfunção de membro .Para obter mais informações, consulte o tópico "Propriedade ODBCTimeout" na Ajuda do DAO.

Comentários

A definiçãodeconsulta é um objeto de classe CDaoQueryDef.As referências a primária, secundária e All acima indicam como as informações fornecidas pelo GetQueryDefInfo função de membro na classe CDaoDatabase.

Informações recuperadas pelo CDaoDatabase::GetQueryDefInfo armazenado em um função de membroCDaoQueryDefInfo estrutura. De telefonarGetQueryDefInfo para o objeto de banco de dados cuja coleção QueryDefs o objeto definiçãodeconsulta está armazenado. CDaoQueryDefInfo também define um Dump cria a função de membro na depurar. Você pode usar Dump Despejar o Sumário de um CDaoQueryDefInfo objeto. De classeCDaoDatabase também fornece funções de membro para acessar diretamente todas as propriedades retornadas em uma CDaoQueryDefInfo o objeto, portanto, provavelmente raramente será necessário para telefonar GetQueryDefInfo.

Quando você anexa um novo campo ou objeto de parâmetro à coleção de campos ou parâmetros de um objeto definiçãodeconsulta, uma exceção é lançada se o banco de dados subjacente não oferecer suporte para o tipo de dados especificado para o novo objeto.

As configurações de data e time são derivadas do computador no qual a definiçãodeconsulta foi criada ou atualizado pela última vez.Em um ambiente multiusuário, os usuários devem obter essas configurações diretamente de servidor de arquivos usando o período líquidocomando para evitar discrepâncias nas configurações de propriedades DateCreated e LastUpdated.