CDaoQueryDefInfo estrutura

A CDaoQueryDefInfo estrutura tem a seguinte forma:

struct CDaoQueryDefInfo
{
 nbsp; CString m_str&Name;               / / Principal
   m_nType curto;                   / / Principal
   COleDateTime m_dateCreated;      / / Secundário
   COleDateTime m_dateLastUpdated;  / / Secundário
   BOOL m_bUpdatable;               / / Secundário
   BOOL m_bReturnsRecords;          / / Secundário
   CString m_strSQL;                / / Tudo
   CString m_strConnect;            / / Tudo
   m_nODBCTimeout curto;            / / Tudo
}

A CDaoQueryDefInfo estrutura contém informações sobre um objeto definiçãodeconsulta definido para dados acessar objetos (DAO). A definiçãodeconsulta é um objeto da classe CDaoQueryDef. As referências para primária, secundária e tudo acima indicam como as informações são retornadas pela função de membro GetQueryDefInfo na classe CDaoDatabase.

Membros

m_strName

Nomes exclusivamente o objeto definiçãodeconsulta. Para obter mais informações, consulte o tópico "Propriedade de nome" na Ajuda do DAO. Chamar CDaoQueryDef::GetName para recuperar diretamente essa propriedade.

m_nType

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

• dbQSelect   Selecione — a consulta seleciona registros.
  
  
• dbQActio&nnbsp;  Ação — a consulta move ou altera dados mas não retornam registros.
  
  
• dbQCrosstab   Tabela de referência cruzada — a consulta retorna dados em um formato de planilha.
  
  
• dbQDelete   Excluir — a consulta excluirá um conjunto de linhas especificados.
  
  
• dbQUpdate   Atualização — a consulta altera um conjunto de registros.
  
  
• dbQAppe&ndnbsp;  Acrescentar — consulta adiciona novos registros ao final de uma tabela ou consulta.
  
  
• dbQMakeTable   Criar tabela — a consulta cria uma nova tabela a partir de um conjunto de registros.
  
  
• dbQDDL   Definição de dados — consulta afeta a estrutura de tabelas ou de suas partes.
  
  
• dbQSQLPassThrough   Pass-through — a instrução SQL é passada diretamente para o banco de dados back-end, sem transformação intermédia.
  
  
• dbQSetOperatio&nnbsp;  União — a consulta cria um objeto recordset do tipo snapshot contendo dados de registros de tudo especificados em duas ou mais tabelas com registros duplicados removidos. Para incluir as duplicatas, adicione a palavra-chave ALL em instrução de SQL do definiçãodeconsulta.
  
  
• dbQSPTBulk   Usado com dbQSQLPassThrough para especificar uma consulta que não retorna registros.

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

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

m_dateCreated

A data e a hora que a definiçãodeconsulta foi criada. Para recuperar diretamente a data que foi criada a definiçãodeconsulta, chame a GetDateCreated função de membro do objeto CDaoTableDef associado com a tabela. Consulte comentários abaixo para obter mais informações. Consulte também o tópico "DataDeCriação, Propriedades LastUpdated" na Ajuda do DAO.

m_dateLastUpdated

A data e hora da alterar mais recente feita a definiçãodeconsulta. Para recuperar diretamente a data em que a tabela foi atualizada, chame a GetDateLastUpdated função de membro do definiçãodeconsulta. Consulte comentários abaixo para obter mais informações. E consulte o tópico "DataDeCriação, Propriedades LastUpdated" na Ajuda do DAO.

m_bUpdatable

Indica se as alterações podem ser feitas a um objeto definiçãodeconsulta. Se essa propriedade for TRUE, a definiçãodeconsulta é atualizável; caso contrário, não é. Updatable significa que definição de consulta do objeto definiçãodeconsulta 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 função de membro CanUpdate do definiçãodeconsulta. Para obter mais informações, consulte o tópico "Propriedade atualizável" na Ajuda do DAO.

m_bReturnsRecords

Indica se uma consulta passagem SQL para 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 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 Selecionar 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 definiçãodeconsulta. A propriedade SQL contém a instrução SQL que determina como os registros são selecionados, ordenados e agrupados quando você executa 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 dados sem retornar registros. Você pode recuperar o valor desta propriedade diretamente, chamando a função de membro GetSQL do definiçãodeconsulta. Para obter mais informações, consulte o artigo DAO consultas no Guia do programador do Visual C++ e o tópico "Propriedade de SQL" na Ajuda do DAO.

m_strConnect

Fornece informações sobre a origem de um banco de dados usado em uma consulta de passagem. Esta informação assume a forma de uma seqüência de conexão. 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 a função de membro CDaoDatabase::GetConnect.

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 por causa da utilização de tráfego ou pesados de rede do servidor ODBC. Ao invés 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 a função de membro GetODBCTimeout do definiçãodeconsulta. Para obter mais informações, consulte o tópico "Propriedade ODBCTimeout" na Ajuda do DAO.

Comentários

Informações recuperadas pelo função de membro de CDaoDatabase::GetQueryDefInfo são armazenadas em uma estrutura de CDaoQueryDefInfo . Chame GetQueryDefInfo para o objeto de banco de dados no cuja coleção QueryDefs do objeto definiçãodeconsulta é armazenado. CDaoQueryDefInfo também define uma função de membro Dump em compilações de Depurar. Você pode usar Dump para despejar o conteúdo de um objeto de CDaoQueryDefInfo . Classe CDaoDatabase também fornece funções de membro para acessar todas as propriedades retornadas em um objeto de CDaoQueryDefInfo , então você provavelmente raramente precisará chamar GetQueryDefInfo diretamente.

Quando você acrescentar um novo campo ou parâmetro objeto para a coleção de campos ou parâmetros 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 a definiçãodeconsulta foi criada ou actualizada. 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 quanto ao DateCreated e LastUpdated configurações de propriedade. Para obter informações sobre como usar esta e outras estruturas de informações da DAO MFC, consulte o artigo DAO coleções: obtenção de informações sobre objetos DAO no Guia do programador do Visual C++.

Co&nsulte tambémnbsp;CDaoQueryDef, CDaoDatabase