Struttura CDaoQueryDefInfo
La struttura di CDaoQueryDefInfo contiene informazioni su un oggetto di querydef definito per DAO (data access (DAO) objects).
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
};
Parametri
m_strName
In modo univoco denominazione l'oggetto di querydef.Per ulteriori informazioni, vedere l'argomento “proprietà name„ nella Guida di DAO.chiamata CDaoQueryDef::GetName per recuperare direttamente questa proprietà.m_nType
Un valore che indica il tipo operativo dell'oggetto del querydef.Il valore può essere:dbQSelect selezionato ovvero la query seleziona i record.
azione didbQActionovvero la query si sposta o i dati delle modifiche ma non restituisce record.
dbQCrosstab Crosstab ovvero la query restituisce i dati in un formato di tipo foglio.
eliminazione didbQDeleteovvero la query elimina un set di righe specificate.
aggiornamento didbQUpdateovvero la query modifica un insieme di record.
dbQAppend aggiunge ovvero la query aggiunge nuovi record al termine di una tabella o di una query.
Fare-tabella didbQMakeTableovvero la query crea una nuova tabella da un recordset.
definizione dei dati didbQDDLovvero la query danneggia la struttura delle tabelle o delle relative parti.
pass-through didbQSQLPassThrough— l'istruzione SQL viene passato direttamente al back-end del database, senza elaborazione intermedia.
unione didbQSetOperationovvero la query crea un oggetto recordset di tipo snapshot che contiene i dati da tutti i record specificati in due o più tabelle con tutti i record duplicati rimossi.Per importare i duplicati, aggiungere la parola chiave TUTTI nell'istruzione SQL di querydef.
dbQSPTBulk utilizzato con dbQSQLPassThrough per specificare una query che non restituisce record.
[!NOTA]
Per creare una query pass-through SQL, non viene impostata una costante di dbQSQLPassThrough .Ciò viene impostata automaticamente dal motore di database Microsoft Jet quando si crea un oggetto di querydef e impostare la proprietà della connessione.
Per ulteriori informazioni, vedere l'argomento “proprietà del tipo„ nella Guida di DAO.
m_dateCreated
La data e l'ora in cui il querydef è stato creato.Per direttamente recuperare la data in cui il querydef è stato creato, che chiamare la funzione membro di GetDateCreated dell'oggetto di CDaoTableDef associata alla tabella.Vedere le note riportato di seguito per ulteriori informazioni.Vedere l'argomento “DateCreated, proprietà di LastUpdated„ nella Guida di DAO.m_dateLastUpdated
La data e l'ora della modifica più recente effettuata a querydef.Per direttamente recuperare la data in cui la tabella è stata aggiornata, che chiamare per ultimo la funzione membro di GetDateLastUpdated di querydef.Vedere le note riportato di seguito per ulteriori informazioni.E vedere l'argomento “DateCreated, proprietà di LastUpdated„ nella Guida di DAO.m_bUpdatable
Indica se le modifiche possono essere apportate a un oggetto di querydef.Se questa proprietà è TRUE, il querydef è aggiornabile, in caso contrario, non è.Implementa aggiornabili la definizione della query dell'oggetto querydef possono essere modificati.La proprietà aggiornabile di un oggetto di querydef è impostata su TRUE se la definizione della query può essere aggiornata, anche se il recordset risultante non è aggiornabile.Per recuperare direttamente questa proprietà, chiamare la funzione membro di CanUpdate di querydef.Per ulteriori informazioni, vedere l'argomento “proprietà aggiornabile„ nella Guida di DAO.m_bReturnsRecords
Indica se pass-through query SQL in un database esterno restituisce record.Se questa proprietà è TRUE, la query restituisce i record.Per direttamente recuperare questa proprietà, chiamare CDaoQueryDef::GetReturnsRecords.Non tutte le query pass-through SQL a restituiscono record di database esterni.Ad esempio, un'istruzione SQL AGGIORNA aggiorna i record senza restituire i record, mentre un'istruzione SQL SELEZIONA restituisce record.Per ulteriori informazioni, vedere l'argomento “proprietà di ReturnsRecords„ nella Guida di DAO.m_strSQL
L'istruzione SQL che definisce la query è stata eseguita da un oggetto di querydef.La proprietà SQL contiene l'istruzione SQL che determina quali record sono selezionati, raggruppati e vengono ordinati quando si esegue la query.È possibile utilizzare la query per selezionare i record da includere in un oggetto recordset di tipo o snapshot dei dynaset.È inoltre possibile definire query di massa per modificare i dati senza restituire i record.È possibile recuperare il valore di questa proprietà direttamente chiamando la funzione membro di GetSQL di querydef.m_strConnect
Vengono fornite informazioni sul database di origine di un database utilizzato in una query pass-through.Queste informazioni hanno il formato di una stringa di connessione.Per ulteriori informazioni sulla connessione delle stringhe e per informazioni su recuperare il valore di questa proprietà direttamente, vedere la funzione membro di CDaoDatabase::GetConnect .m_nODBCTimeout
Il numero di secondi che il modulo di gestione di database Microsoft Jet è in attesa prima che un errore di timeout si verifica quando una query viene eseguito in un database ODBC.Quando si utilizza un database ODBC, quale Microsoft SQL Server, possono essere ritardi a causa del traffico di rete o di un ingente utilizzo di ODBC.Anziché aspettare indefinito, è possibile specificare la durata il motore di Microsoft Jet prima che generato un errore.Il valore di timeout predefinito è 60 secondi.È possibile recuperare il valore di questa proprietà direttamente chiamando la funzione membro di GetODBCTimeout di querydef.Per ulteriori informazioni, vedere l'argomento “proprietà di ODBCTimeout„ nella Guida di DAO.
Note
il querydef è un oggetto di classe CDaoQueryDef.I riferimenti a primario, a secondario e tutti su indicano come le informazioni restituite dalla funzione membro di GetQueryDefInfo nella classe CDaoDatabase.
Le informazioni recuperate dalla funzione membro di CDaoDatabase::GetQueryDefInfo vengono archiviate in una struttura di CDaoQueryDefInfo .Chiamare GetQueryDefInfo per l'oggetto di database che nella raccolta di QueryDefs l'oggetto di querydef viene archiviato.CDaoQueryDefInfo definisce anche una funzione membro di Dump nelle build di debug.È possibile utilizzare Dump per eseguire il dump del contenuto di un oggetto di CDaoQueryDefInfo .La classe CDaoDatabase fornisce inoltre le funzioni membro per accedere direttamente a tutte le proprietà restituite in un oggetto di CDaoQueryDefInfo , pertanto sarà probabilmente raramente chiamare GetQueryDefInfo.
Quando si aggiungono un nuovo campo o oggetto Parameter per campi o raccolta di parametri di oggetto di querydef, viene generata un'eccezione se il database sottostante non supporta il tipo di dati specificato per il nuovo oggetto.
Le impostazioni di data e ora sono derivate dal computer nel quale querydef è stato creato o l'ultimo aggiornato.In un ambiente multiutente, gli utenti devono ottenere queste impostazioni direttamente dal file server utilizzando il comando di net time evitare le differenze nelle impostazioni delle proprietà di LastUpdated e di DateCreated.
Requisiti
Header: afxdao.h