Struttura CDaoQueryDefInfo

La CDaoQueryDefInfo struttura contiene informazioni su un oggetto querydef definito per gli oggetti DAO (Data Access Objects).

Sintassi

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
Denomina in modo univoco l'oggetto querydef. Per altre informazioni, vedere l'argomento "Proprietà nome" nella Guida di DAO. Chiama CDaoQueryDef::GetName per recuperare direttamente questa proprietà.

m_nType
Valore che indica il tipo operativo di un oggetto querydef. Il valore può essere uno dei seguenti:

• dbQSelect Selezionare: la query seleziona i record.

• dbQAction Azione: la query sposta o modifica i dati, ma non restituisce record.

• dbQCrosstab Campi incrociati: la query restituisce i dati in un formato simile al foglio di calcolo.

• dbQDelete Elimina: la query elimina un set di righe specificate.

• dbQUpdate Aggiornamento: la query modifica un set di record.

• dbQAppend Accoda: la query aggiunge nuovi record alla fine di una tabella o di una query.

• dbQMakeTable Make-table: la query crea una nuova tabella da un recordset.

• dbQDDL Definizione dei dati: la query influisce sulla struttura delle tabelle o sulle relative parti.

• dbQSQLPassThrough Pass-through: l'istruzione SQL viene passata direttamente al back-end del database, senza elaborazione intermedia.

• dbQSetOperation Unione: la query crea un oggetto recordset di tipo snapshot contenente i dati di tutti i record specificati in due o più tabelle con record duplicati rimossi. Per includere i duplicati, aggiungere la parola chiave ALL nell'istruzione SQL di querydef.

• dbQSPTBulk Usato con dbQSQLPassThrough per specificare una query che non restituisce record.

Per altre informazioni, vedere l'argomento "Type Property" nella Guida di DAO.

m_dateCreated
Data e ora di creazione dell'oggetto querydef. Per recuperare direttamente la data di creazione della querydef, chiamare la funzione membro GetDateCreated dell'oggetto CDaoTableDef associato alla tabella. Per altre informazioni, vedere Note. Vedere anche l'argomento "DateCreated, LastUpdated Properties" nella Guida di DAO.

m_dateLastUpdated
Data e ora della modifica più recente apportata all'oggetto querydef. Per recuperare direttamente la data dell'ultimo aggiornamento della tabella, chiamare la funzione membro GetDateLastUpdated dell'oggetto querydef. Per altre informazioni, vedere Note. Vedere anche l'argomento "DateCreated, LastUpdated Properties" nella Guida di DAO.

m_bUpdatable
Indica se è possibile apportare modifiche a un oggetto querydef. Se questa proprietà è TRUE, querydef è aggiornabile; in caso contrario, non lo è. Aggiornabile indica che è possibile modificare la definizione di query dell'oggetto querydef. La proprietà Updatable di un oggetto 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 CanUpdate di querydef. Per altre informazioni, vedere l'argomento "Proprietà aggiornabile" nella Guida di DAO.

m_bReturnsRecords
Indica se una query pass-through SQL a un database esterno restituisce record. Se questa proprietà è TRUE, la query restituisce i record. Per recuperare direttamente questa proprietà, chiamare CDaoQueryDef::GetReturnsRecords. Non tutte le query pass-through SQL ai database esterni restituiscono record. Ad esempio, un'istruzione SQL UPDATE aggiorna i record senza restituire record, mentre un'istruzione SQL SELECT restituisce record. Per altre informazioni, vedere l'argomento "Proprietà ReturnsRecords" nella Guida di DAO.

m_strSQL
Istruzione SQL che definisce la query eseguita da un oggetto querydef. La proprietà SQL contiene l'istruzione SQL che determina la modalità di selezione, raggruppamento e ordinamento dei record durante l'esecuzione della query. È possibile usare la query per selezionare i record da includere in un oggetto recordset di tipo dynaset o snapshot. È anche possibile definire query in blocco per modificare i dati senza restituire record. È possibile recuperare il valore di questa proprietà direttamente chiamando la funzione membro GetSQL di querydef.

m_strConnect
Fornisce informazioni sull'origine di un database utilizzato in una query pass-through. Queste informazioni hanno la forma di una stringa di connessione. Per altre informazioni sulle stringhe di connessione e per informazioni sul recupero diretto del valore di questa proprietà, vedere la funzione membro CDaoDatabase::GetConnect .

m_nODBCTimeout
Numero di secondi di attesa del motore di database Microsoft Jet prima che si verifichi un errore di timeout quando una query viene eseguita in un database ODBC (Open Database Connectivity). Quando si usa un database ODBC, ad esempio Microsoft SQL Server, potrebbero verificarsi ritardi a causa del traffico di rete o di un uso elevato del server ODBC. Anziché attendere per un periodo illimitato, è possibile specificare per quanto tempo il motore Microsoft Jet attende prima che venga generato un errore. Il valore di timeout predefinito è 60 secondi. È possibile recuperare il valore di questa proprietà direttamente chiamando la funzione membro GetODBCTimeout di querydef. Per altre informazioni, vedere l'argomento "Proprietà ODBCTimeout" nella Guida di DAO.

Osservazioni:

Querydef è un oggetto della classe CDaoQueryDef. I riferimenti a Primary, Secondary e All indicano come vengono restituite le informazioni dalla funzione membro GetQueryDefInfo nella classe CDaoDatabase.

Le informazioni recuperate dalla funzione membro CDaoDatabase::GetQueryDefInfo vengono archiviate in una CDaoQueryDefInfo struttura. Chiamare GetQueryDefInfo per l'oggetto di database nella cui raccolta QueryDefs è archiviato l'oggetto querydef. CDaoQueryDefInfo definisce anche una Dump funzione membro nelle compilazioni di debug. È possibile usare Dump per eseguire il dump del contenuto di un CDaoQueryDefInfo oggetto . La classe CDaoDatabase fornisce anche funzioni membro per l'accesso diretto a tutte le proprietà restituite in un CDaoQueryDefInfo oggetto, in modo da chiamare GetQueryDefInforaramente .

Quando si aggiunge un nuovo oggetto campo o parametro all'insieme Fields o Parameters di un oggetto 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 derivano dal computer in cui è stato creato o aggiornato l'ultimo querydef. In un ambiente multiutente, gli utenti devono ottenere queste impostazioni direttamente dal file server usando il comando net time per evitare discrepanze nelle impostazioni della proprietà DateCreated e LastUpdated.

Requisiti

Intestazione: afxdao.h

Vedi anche

Strutture, stili, callback e mappe messaggi
Classe CDaoQueryDef
Classe CDaoDatabase