CDaoQueryDefInfo estrutura

Artigo
02/25/2013

O CDaoQueryDefInfo estrutura contém informações sobre um objeto querydef definido 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
Nomes exclusivamente o objeto querydef.Para obter mais informações, consulte o tópico "Propriedade de nome" na Ajuda do DAO.Chamar CDaoQueryDef::GetName para recuperar esta propriedade diretamente.

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

dbQSelect selecione — a consulta seleciona registros.
dbQAction ação — a consulta move ou altera dados mas não retornar registros.
dbQCrosstab tabela de referência cruzada, a consulta retorna dados em um formato de planilha.
dbQDelete excluir — exclui de consulta um conjunto de linhas especificados.
dbQUpdate atualização — a consulta altera um conjunto de registros.
dbQAppend acrescentar — consulta adiciona novos registros ao final de uma tabela ou consulta.
dbQMakeTable criar tabela — a consulta cria uma nova tabela de um conjunto de registros.
dbQDDL definição de dados — consulta afeta a estrutura de tabelas ou de suas partes.
dbQSQLPassThrough passagem — a instrução SQL é passada diretamente para o back-end de banco de dados, sem processamento intermediário.
dbQSetOperation união — consulta cria um objeto recordset tipo snapshot contendo dados de especificado todos os registros em duas ou mais tabelas com registros duplicados removidos.Para incluir as duplicatas, adicione a palavra-chave todos os na instrução de SQL de querydef.
dbQSPTBulk usado com dbQSQLPassThrough para especificar uma consulta que não retorna registros.

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

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

m_dateCreated
A data e hora que QueryDef foi criado.Para recuperar diretamente a data querydef foi criada, chame o GetDateCreated função de membro de CDaoTableDef objeto associado com a tabela.Consulte comentários abaixo para obter mais informações.Consulte também o tópico "DateCreated e LastUpdated Properties" na Ajuda do DAO.
m_dateLastUpdated
A data e hora da alteração mais recente feita querydef.Para recuperar diretamente a data em que a tabela foi atualizada pela última vez, chame o GetDateLastUpdated função de membro de querydef.Consulte comentários abaixo para obter mais informações.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 querydef.Se essa propriedade for TRUE, querydef é atualizável; Caso contrário, ele não é.Updatable significa a que definição de consulta do objeto querydef pode ser alterada.A propriedade atualizável de um objeto querydef é definida como TRUE se a definição de consulta pode ser atualizada, mesmo se o conjunto de registros resultante não é atualizável.Para recuperar diretamente essa propriedade, chame o querydef CanUpdate funçã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 de passagem SQL 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 para bancos de dados externos retornam registros.Por exemplo, um SQL atualização instrução atualiza registros sem retornar registros, enquanto um SQL Selecionar instrução retornar registros.Para obter mais informações, consulte 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 declaração de SQL que determina como registros são selecionados, agrupados e classificados quando executar a consulta.Você pode usar a consulta para selecionar registros para incluir em um objeto recordset tipo dynaset ou snapshot.Você também pode definir consultas em massa para modificar os dados sem retornar registros.Você pode recuperar o valor desta propriedade diretamente, chamando o querydef GetSQL função de membro.
m_strConnect
Fornece informações sobre a origem de um banco de dados usado em uma consulta passagem.Essas informações assume a forma de uma seqüência de conexão.Para obter mais informações sobre seqüências de conexão e para obter informações sobre como recuperar o valor desta propriedade diretamente, consulte o CDaoDatabase::GetConnect funçã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, como Microsoft SQL Server, pode haver atrasos devido de rede tráfego ou uso intenso do servidor ODBC.Em vez de esperar indefinidamente, você pode especificar quanto tempo o mecanismo Microsoft Jet aguarda antes de ele produz um erro.O valor de tempo limite padrão é 60 segundos.Você pode recuperar o valor desta propriedade diretamente, chamando o querydef GetODBCTimeout função de membro.Para obter mais informações, consulte o tópico "Propriedade ODBCTimeout" na Ajuda do DAO.

Comentários

Querydef é um objeto da classe CDaoQueryDef.Referências primária, secundária e tudo acima indicam como as informações são retornadas pelo GetQueryDefInfo função de membro na classe CDaoDatabase.

As informações recuperadas pelo CDaoDatabase::GetQueryDefInfo função de membro é armazenada em um CDaoQueryDefInfo estrutura.Chamar GetQueryDefInfo para o objeto de banco de dados cuja coleção QueryDefs do objeto querydef é armazenado.CDaoQueryDefInfotambém define um Dump membro na depuração compilações.Você pode usar Dump para despejar o conteúdo de um CDaoQueryDefInfo objeto.Classe CDaoDatabase também fornece funções de membro para acessar diretamente todas as propriedades retornadas em um CDaoQueryDefInfo de objeto, portanto você provavelmente raramente precisará chamar GetQueryDefInfo.

Ao acrescentar um novo campo ou objeto de parâmetro para a coleção de parâmetros ou campos de um objeto querydef, uma exceção é lançada se o banco de dados subjacente não suporta o 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.Em um ambiente multiusuário, os usuários devem obter essas configurações diretamente do servidor de arquivos usando o net time comando para evitar discrepâncias nas configurações das propriedades DateCreated e LastUpdated.