Estrutura CDaoQueryDefInfo

Artigo
06/10/2015

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

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
Nomear exclusivamente o objeto de querydef. Para obter mais informações, consulte o tópico “propriedade nome” na ajuda de DAO. Chame CDaoQueryDef::GetName para recuperar diretamente essa propriedade.
m_nType
Um valor que indica o tipo operacional de um objeto de querydef. O valor pode ser um dos seguintes:
- dbQSelect selecione — a consulta selecionar registros.
- ação dedbQAction— a consulta são movidos ou os dados de alterações mas não retornam se registros.
- tabela de referência cruzada dedbQCrosstab— a consulta retorna dados em uma grade de planilha como o formato.
- exclusão dedbQDelete— a consulta a seguir exclui um conjunto de linhas especificadas.
- atualização dedbQUpdate— a consulta altera um conjunto de registros.
- dbQAppend acrescenta — a consulta adiciona novos registros ao término de uma tabela ou uma consulta.
- conflitantes tabela dedbQMakeTable— a consulta cria uma nova tabela de um conjunto de registros.
- definição de dados dedbQDDL— a consulta afeta a estrutura das tabelas ou as suas partes.
- passagem dedbQSQLPassThrough— a instrução SQL é passada diretamente ao back-end da base de dados, sem processamento intermediária.
- união dedbQSetOperation— a consulta cria um objeto do conjunto de registros de instantâneo- tipo que contém dados de todos os registros especificados em duas ou mais tabelas com alguns registros duplicados removidos. Para incluir as duplicatas, adicione a palavra-chave ALL na instrução SQL de querydef.
- dbQSPTBulk usado com dbQSQLPassThrough para especificar uma consulta que não retorna registros.
Dica

Para criar uma consulta de passagem do SQL, não define a constante de dbQSQLPassThrough .Isso será definido automaticamente pelo mecanismo de base de dados do Microsoft Jet quando você cria um objeto de querydef e define a propriedade se conectar.

Para obter mais informações, consulte o tópico “propriedade tipo” na ajuda de DAO.
m_dateCreated
A data e a hora em que o querydef foi criado. Para recuperar diretamente a data em que o querydef foi criado, chamará a função de membro de GetDateCreated do objeto de CDaoTableDef associado à tabela. Consulte os comentários abaixo para obter mais informações. Também consulte o tópico “DateCreated, propriedades de LastUpdated” na ajuda de DAO.
m_dateLastUpdated
A data e a hora da alteração mais recente feita ao querydef. Para recuperar diretamente a data em que a tabela foi atualizado, chame a função de membro de GetDateLastUpdated de querydef. Consulte os comentários abaixo para obter mais informações. E consulte o tópico “DateCreated, propriedades de LastUpdated” na ajuda de DAO.
m_bUpdatable
Indica se as alterações podem ser feitas a um objeto de querydef. Se essa propriedade for Verdadeiro, o querydef é atualizável; caso contrário, não. A mídia atualizáveis a definição de consulta do objeto de querydef podem ser alterados. A propriedade de um objeto atualizável de querydef está definida como Verdadeiro se a definição de consulta pode ser atualizada, se o conjunto de registros resultante não é atualizável. Para recuperar diretamente essa propriedade, chame a função de membro de CanUpdate de querydef. Para obter mais informações, consulte o tópico “propriedade atualizável” na ajuda de DAO.
m_bReturnsRecords
Indica se uma consulta passagem do SQL para um base de dados externo retorna registros. Se essa propriedade for Verdadeiro, a consulta retorna registros. Para recuperar diretamente essa propriedade, chame CDaoQueryDef::GetReturnsRecords. Nem todas as consultas de passagem do SQL aos registros externos de retorno de bases de dados. Por exemplo, uma instrução SQL ATUALIZAR atualiza registros sem retornar registros, quando uma instrução SQL SELECIONAR retornar registros. Para obter mais informações, consulte o tópico “propriedade ReturnsRecords” na ajuda de DAO.
m_strSQL
A instrução SQL que define a consulta executada por um objeto de querydef. A propriedade do 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 dynaset- ou conjunto de registros de instantâneo- tipo. Você também pode definir consultas em massa para alterar dados sem retornar registros. Você pode recuperar o valor dessa propriedade diretamente chamando a função de membro de GetSQL de querydef.
m_strConnect
Fornece informações sobre a origem de um base de dados usado em uma consulta de passagem. Essas informações assume a forma de uma cadeia de caracteres se conectar. Para obter mais informações sobre a conexão cadeias de caracteres, e para obter informações sobre como recuperar o valor dessa propriedade diretamente, consulte a função de membro de CDaoDatabase::GetConnect .
m_nODBCTimeout
O número de segundos que o mecanismo de base de dados do Microsoft Jet espera antes que um erro de tempo limite ocorre quando uma consulta é executada em uma base de dados do ODBC. Quando você está usando uma base de dados de ODBC, como Microsoft SQL Server, pode haver atrasos devido ao tráfego de rede ou ao uso intenso do servidor ODBC. Em vez de esperar indefinidamente, você pode especificar por quanto tempo o mecanismo do Microsoft Jet espera antes que gerencia um erro. O valor de tempo limite padrão é de 60 segundos. Você pode recuperar o valor dessa propriedade diretamente chamando a função de membro de GetODBCTimeout de querydef. Para obter mais informações, consulte o tópico “propriedade ODBCTimeout” na ajuda de DAO.

Comentários

O querydef é um objeto da classe CDaoQueryDef. As referências à primário, secundário, e todas as anterior indicam como as informações são retornadas pela função de membro de GetQueryDefInfo na classe CDaoDatabase.

As informações recuperadas pela função de membro de CDaoDatabase::GetQueryDefInfo são armazenadas em uma estrutura de CDaoQueryDefInfo . Chame GetQueryDefInfo para o objeto base de dados cuja na coleção de QueryDefs o objeto de querydef é armazenado. CDaoQueryDefInfo também define uma função de membro de Dump em construções de depuração. Você pode usar para Dump despejar os conteúdos de um objeto de CDaoQueryDefInfo . A classe CDaoDatabase também fornece funções de membro para acessar diretamente todas as propriedades retornadas em um objeto de CDaoQueryDefInfo , assim será necessário provavelmente raramente de chamar GetQueryDefInfo.

Quando você adiciona um novo objeto de campo ou de parâmetro à coleção de campos ou os parâmetros de um objeto de querydef, uma exceção será gerada se o base de dados subjacente não oferece suporte ao tipo de dados especificado para o novo objeto.

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