Estrutura CDaoQueryDefInfo

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

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 de forma única o objeto querydef. Para mais informações, consulte o tópico "Nome de Propriedade" no DAO Help. Ligue para 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 dos seguintes:

• dbQSelect Selecionar: a consulta seleciona registos.

• dbQAction Ação: a consulta move ou altera dados mas não retorna registos.

• dbQCrosstab Tabela cruzada: a consulta devolve dados num formato semelhante a uma folha de cálculo.

• dbQDelete Eliminar: a consulta elimina um conjunto de linhas especificadas.

• dbQUpdate Atualização: a consulta altera um conjunto de registos.

• dbQAppend Anexar: a consulta adiciona novos registos ao final de uma tabela ou consulta.

• dbQMakeTable Make-table: a consulta cria uma nova tabela a partir de um conjunto de registos.

• dbQDDL Definição de dados: a consulta afeta a estrutura das tabelas ou das suas partes.

• dbQSQLPassThrough Pass-through: a instrução SQL é passada diretamente para o backend da base de dados, sem processamento intermédio.

• dbQSetOperation União: a consulta cria um objeto de registo do tipo snapshot contendo dados de todos os registos especificados em duas ou mais tabelas, com quaisquer registos duplicados removidos. Para incluir os duplicados, adicione a palavra-chave ALL na instrução SQL do querydef.

• dbQSPTBulk Usado com dbQSQLPassThrough para especificar uma consulta que não devolve registos.

Para mais informações, consulte o tópico "Propriedade de Tipo" no DAO Help.

m_dateCreated
A data e hora em que o querydef foi criado. Para recuperar diretamente a data em que o querydef foi criado, chame a função membro GetDateCreated do CDaoTableDef objeto associado à tabela. Para obter mais informações, veja Observações. Veja também o tópico "DateCreated, LastUpdated Properties" na Ajuda do DAO.

m_dateLastUpdated
A data e hora da alteração mais recente feita ao querydef. Para recuperar diretamente a data em que a tabela foi atualizada pela última vez, chame a função membro GetDateLastUpdated do querydef. Para obter mais informações, veja Observações. Veja também o tópico "DateCreated, LastUpdated Properties" na Ajuda do DAO.

m_bUpdatable
Indica se podem ser feitas alterações a um objeto querydef. Se esta propriedade for VERDADEIRA, o querydef é atualizável; caso contrário, não é. Atualizável significa que a definição da consulta do objeto querydef pode ser alterada. A propriedade Atualizável de um objeto querydef é definida como TRUE se a definição da consulta puder ser atualizada, mesmo que o conjunto de registos resultante não seja atualizável. Para recuperar esta propriedade diretamente, chame a função membro CanUpdate do querydef. Para mais informações, consulte o tópico "Propriedade Atualizável" no DAO Help.

m_bReturnsRecords
Indica se uma consulta SQL pass-through para uma base de dados externa devolve registos. Se esta propriedade for VERDADEIRA, a consulta devolve registos. Para recuperar diretamente esta propriedade, ligue para CDaoQueryDef::GetReturnsRecords. Nem todas as consultas SQL pass-through para bases de dados externas devolvem registos. Por exemplo, uma instrução SQL UPDATE atualiza registos sem devolver registos, enquanto uma instrução SQL SELECT devolve registos. Para mais informações, consulte o tópico "ReturnsRecords Property" na Ajuda 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 registos são selecionados, agrupados e ordenados quando executas a consulta. Pode usar a consulta para selecionar registos a incluir num objeto de recordet do tipo dynaset ou snapshot. Também pode definir consultas em massa para modificar dados sem devolver registos. Pode recuperar o valor desta propriedade diretamente chamando a função membro GetSQL do querydef.

m_strConnect
Fornece informação sobre a origem de uma base de dados utilizada numa consulta de passagem. Esta informação assume a forma de uma cadeia de conexão. Para mais informações sobre as strings Connect e para obter diretamente o valor desta propriedade, consulte a função membro CDaoDatabase::GetConnect .

m_nODBCTimeout
O número de segundos que o motor da base de dados Microsoft Jet espera antes de ocorrer um erro de timeout quando uma consulta é executada numa base de dados Open Database Connectivity (ODBC). Quando utiliza uma base de dados ODBC, como o Microsoft SQL Server, pode haver atrasos devido ao tráfego de rede ou ao uso intensivo do servidor ODBC. Em vez de esperar indefinidamente, pode especificar quanto tempo o motor do Microsoft Jet espera antes de produzir um erro. O valor padrão de timeout é de 60 segundos. Pode recuperar o valor desta propriedade diretamente chamando a função membro GetODBCTimeout da querydef. Para mais informações, consulte o tópico "Propriedade ODBCTimeout" na Ajuda DAO.

Observações

O querydef é um objeto da classe CDaoQueryDef. As referências a Primário, Secundário e All indicam como a informação é devolvida pela função membro GetQueryDefInfo na classe CDaoDatabase.

A informação recuperada pela função membro CDaoDatabase::GetQueryDefInfo é armazenada numa CDaoQueryDefInfo estrutura. Chame GetQueryDefInfo para o objeto da base de dados em cuja coleção QueryDefs o objeto querydef está armazenado. CDaoQueryDefInfo também define uma Dump função membro em builds de depuração. Podes usar Dump para despejar o conteúdo de um CDaoQueryDefInfo objeto. Class CDaoDatabase também fornece funções membros para aceder diretamente a todas as propriedades devolvidas num CDaoQueryDefInfo objeto, por isso raramente se chama GetQueryDefInfo.

Quando adiciona um novo campo ou objeto de parâmetro à coleção de Campos ou Parâmetros de um objeto querydef, é lançada uma exceção se a base de dados subjacente não suportar o tipo de dado especificado para o novo objeto.

As definições de data e hora são derivadas do computador onde o querydef foi criado ou atualizado pela última vez. Num ambiente multiutilizador, os utilizadores devem obter estas definições diretamente do servidor de ficheiros usando o comando net time para evitar discrepâncias nas propriedades DateCreated e LastUpdate.

Requerimentos

Cabeçalho:afxdao.h

Consulte também

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