Struttura CDaoQueryDefInfo

La struttura CDaoQueryDefInfo ha la seguente forma:

struct CDaoQueryDefInfo
{
 nbsp; CString m_str&Name;               / / Primaria
   breve m_nType;                   / / Primaria
   COleDateTime m_dateCreated;      / / Secondarie
   COleDateTime m_dateLastUpdated;  / / Secondarie
   BOOL m_bUpdatable;               / / Secondarie
   BOOL m_bReturnsRecords;          / / Secondarie
   CString m_strSQL;                / / All
   CString m_strConnect;            / / All
   breve m_nODBCTimeout;            / / All
}

La struttura CDaoQueryDefInfo contiene informazioni su un oggetto querydef definito per data access objects (DAO). Il querydef è un oggetto della classe CDaoQueryDef. I riferimenti alle primarie, secondarie e tutti sopra indicano come le informazioni vengono restituite dalla funzione membro GetQueryDefInfo nella classe CDaoDatabase.

Membri

m_strName

Nomi in modo univoco l'oggetto querydef. Per ulteriori informazioni, vedere l'argomento "Nome proprietà" nell'aiuto di DAO. Chiamata CDaoQueryDef::GetName per recuperare questa proprietà direttamente.

m_nType

Un valore che indica il tipo operativo di un oggetto querydef. Il valore può essere una delle seguenti:

• dbQSelect   Selezionare — la query seleziona record.
  
  
• dbQActio&nnbsp;  Azione — la query si muove o modifica dati ma non restituisce record.
  
  
• dbQCrosstab   A campi incrociati — la query restituisce i dati in un formato simile a foglio di calcolo.
  
  
• dbQDelete   Elimina — la query consente di eliminare un set di righe specificate.
  
  
• dbQUpdate   Aggiornamento — la query cambia un set di record.
  
  
• dbQAppe&ndnbsp;  Accodare — la query aggiunge nuovi record alla fine di una tabella o query.
  
  
• dbQMakeTable   Creazione tabella — la query crea una nuova tabella di un recordset.
  
  
• dbQDDL   Definizione dei dati — la query colpisce la struttura delle tabelle o di loro parti.
  
  
• dbQSQLPassThrough   Pass-through — l'istruzione SQL viene passato direttamente al database backend, senza elaborazione intermedia.
  
  
• dbQSetOperatio&nnbsp;  Unione — la query crea un oggetto di tipo snapshot recordset contenente i dati dai registri tutto specificati in due o più tabelle con qualsiasi record duplicati rimosso. Per includere i duplicati, aggiungere la parola chiave tutti nell'istruzione SQL dell'oggetto querydef.
  
  
• dbQSPTBulk   Utilizzata con dbQSQLPassThrough per specificare una query che non restituisce record.

  &Notanbsp;  Per creare una query pass-through SQL, non è impostare la costante dbQSQLPassThrough . Questo viene impostato automaticamente dal motore di database Microsoft Jet quando si crea un oggetto querydef e imposta la proprietà Connect.

  Per ulteriori informazioni, vedere l'argomento "Proprietà del tipo" nell'aiuto di DAO.

m_dateCreated

La data e l'ora che è stato creato l'oggetto querydef. Per recuperare direttamente la data di che creazione oggetto querydef, chiamare la funzione membro GetDateCreated dell'oggetto CDaoTableDef associato alla tabella. Per ulteriori informazioni, vedere commenti qui sotto. Vedere anche l'argomento "DateCreated, proprietà LastUpdated" nell'aiuto di DAO.

m_dateLastUpdated

La data e l'ora del più recente cambiamento fatto per il querydef. Per recuperare direttamente la data che dell'ultimo aggiornamento della tabella, chiamare la funzione membro GetDateLastUpdated dell'oggetto querydef. Per ulteriori informazioni, vedere commenti qui sotto. E vedere l'argomento "DateCreated, proprietà LastUpdated" nell'aiuto di DAO.

m_bUpdatable

Indica se è possibile apportare modifiche a un oggetto querydef. Se questa proprietà è TRUE, l'oggetto querydef è aggiornabile; in caso contrario, non è. Updatable significa che può essere cambiato la definizione della query dell'oggetto querydef. La proprietà aggiornabile di un oggetto querydef è impostata su TRUE se la definizione della query può essere aggiornata, anche se il recordset risultante non è aggiornabile. Per recuperare questa proprietà direttamente, chiamare la funzione di membro dell'oggetto querydef CanUpdate . Per ulteriori 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 per i database esterni restituire record. Ad esempio, un'istruzione SQL UPDATE aggiorna record senza ritorno record, mentre un'istruzione SQL selezionare restituire record. Per ulteriori informazioni, vedere l'argomento "Proprietà ReturnsRecords" nell'aiuto di DAO.

m_strSQL

L'istruzione SQL che definisce la query eseguita da un oggetto querydef. La proprietà SQL contiene l'istruzione SQL che determina come record vengono selezionati, raggruppati e ordinati quando si esegue la query. È possibile utilizzare la query per selezionare i record da includere in un oggetto recordset di tipo dynaset o snapshot. È inoltre possibile definire le query di massa per modificare i dati senza ritornare record. È possibile recuperare il valore di questa proprietà direttamente chiamando la funzione di membro dell'oggetto querydef GetSQL . Per ulteriori informazioni, vedere l'articolo Query DAO nel manuale del programmatore di Visual C++ e l'argomento "Proprietà SQL" nella guida di DAO.

m_strConnect

Fornisce informazioni sull'origine di un database utilizzato in una query pass-through. Questa informazione assume la forma di una stringa di connessione. Per ulteriori informazioni circa connettersi stringhe e per informazioni sul recupero direttamente il valore di questa proprietà, vedere la funzione membro CDaoDatabase::GetConnect.

m_nODBCTimeout

Il numero di secondi di che attesa di motore di database Microsoft Jet prima di un errore di timeout si verifica durante l'esecuzione di una query su un database ODBC. Quando si utilizza un database ODBC, quale Microsoft SQL Server, possono esserci ritardi a causa dell'uso di traffico o pesanti di rete del server ODBC. Piuttosto che in attesa a tempo indeterminato, è possibile specificare tempo Microsoft Jet engine di attesa prima che esso genera un errore. Il valore di timeout predefinito è 60 secondi. È possibile recuperare il valore di questa proprietà direttamente chiamando la funzione di membro GetODBCTimeout dell'oggetto querydef. Per ulteriori informazioni, vedere l'argomento "Proprietà ODBCTimeout" nell'aiuto di DAO.

Commenti

Estratto dalla funzione membro CDaoDatabase::GetQueryDefInfo di informazioni vengono archiviate in una struttura CDaoQueryDefInfo . Chiamare GetQueryDefInfo per l'oggetto di database in cui insieme QueryDefs è memorizzato l'oggetto querydef. CDaoQueryDefInfo definisce anche una funzione membro Dump nelle build di debug. È possibile utilizzare Dump per eseguire il dump del contenuto di un oggetto CDaoQueryDefInfo . Classe CDaoDatabase fornisce anche le funzioni di membro per direttamente l'accesso a tutte le proprietà restituite in un oggetto CDaoQueryDefInfo , quindi è probabilmente raramente necessario chiamare GetQueryDefInfo.

Quando si aggiunge un nuovo campo o parametro un oggetto all'insieme di parametri o campi 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 sono derivate dal computer su cui oggetto querydef è stato creato o aggiornato. In un ambiente multiutente, gli utenti dovrebbero ottenere queste impostazioni direttamente dal file server utilizzando il comando net time per evitare delle discrepanze nelle DateCreated e le impostazioni della proprietà LastUpdated. Per informazioni sull'utilizzo di questa e altre strutture Info DAO MFC, vedere l'articolo insiemi DAO: recupero di informazioni sugli oggetti DAO nel manuale del programmatore di Visual C++.

Vedere a&nchenbsp;CDaoQueryDef, CDaoDatabase