Struttura CDaoTableDefInfo

Articolo
03/05/2013

La struttura di CDaoTableDefInfo contiene informazioni su un oggetto di TableDef definito per DAO (data access (DAO) objects).

struct CDaoTableDefInfo
{
   CString m_strName;               // Primary
   BOOL m_bUpdatable;               // Primary
   long m_lAttributes;              // Primary
   COleDateTime m_dateCreated;      // Secondary
   COleDateTime m_dateLastUpdated;  // Secondary
   CString m_strSrcTableName;       // Secondary
   CString m_strConnect;            // Secondary
   CString m_strValidationRule;     // All
   CString m_strValidationText;     // All
   long m_lRecordCount;             // All
};

Parametri

m_strName
In modo univoco denominazione degli oggetti TableDef.Per recuperare direttamente il valore di questa proprietà, chiamare la funzione membro di GetName di oggetti TableDef.Per ulteriori informazioni, vedere l'argomento “proprietà name„ nella Guida di DAO.
m_bUpdatable
Indica se le modifiche possono essere apportate alla tabella.La modalità veloce determinare se una tabella è aggiornabile è di aprire un oggetto di CDaoTableDef per la tabella e di chiamare la funzione membro di CanUpdate dell'oggetto.CanUpdate restituisce sempre diverso da zero (TRUE) per un oggetto e un 0 oggetto appena creato TableDef (FALSE) per un oggetto associato di TableDef.Un nuovo oggetto di TableDef può essere aggiunto a un solo database per il quale l'utente corrente dispone delle autorizzazioni di scrittura.Se la tabella contiene solo i campi nonupdatable, restituisce 0 di CanUpdate .Quando uno o più campi sono aggiornabili, CanUpdate restituisce diverso da zero.È possibile modificare soltanto i campi aggiornabili.Per ulteriori informazioni, vedere l'argomento “proprietà aggiornabile„ nella Guida di DAO.
m_lAttributes
Specifica le caratteristiche della tabella rappresentata dall'oggetto TableDef.Per recuperare attributi correnti di un TableDef, chiamare la funzione membro di GetAttributes .Il valore restituito può essere una combinazione di queste costanti estesi (tramite il bit per bit (|( operatore):
- dbAttachExclusive per i database che utilizzano il modulo di gestione di database Microsoft Jet, indica che la tabella è una tabella collegata stato aperto in modo esclusivo.
- dbAttachSavePWD per i database che utilizzano il modulo di gestione di database Microsoft Jet, indica che l'ID utente e la password per la tabella collegata vengono salvati con le informazioni di connessione.
- dbSystemObject indica che la tabella è una tabella di sistema fornita dal modulo di gestione di database Microsoft Jet.(di sola lettura).
- dbHiddenObject indica che la tabella è una tabella nascosta fornita dal modulo di gestione di database Microsoft Jet (per l'utilizzo di gestione temporanea).(di sola lettura).
- dbAttachedTable indica che la tabella è una tabella collegata da un database non ODBC, ad esempio un database di Paradox.
- dbAttachedODBC indica che la tabella è una tabella collegata da un database ODBC, quale Microsoft SQL Server.
m_dateCreated
La data e l'ora che la tabella sia stata creata.Per direttamente recuperare la data in cui la tabella è stata creata, che chiamare la funzione membro di GetDateCreated dell'oggetto di CDaoTableDef associata alla tabella.Vedere le note riportato di seguito per ulteriori informazioni.Per informazioni correlate, vedere l'argomento “DateCreated, proprietà di LastUpdated„ nella Guida di DAO.
m_dateLastUpdated
La data e l'ora della modifica più recente effettuata alla progettazione della tabella.Per direttamente recuperare la data in cui la tabella l'ultima volta che è stata aggiornata, che chiamare la funzione membro di GetDateLastUpdated dell'oggetto di CDaoTableDef associata alla tabella.Vedere le note riportato di seguito per ulteriori informazioni.Per informazioni correlate, vedere l'argomento “DateCreated, proprietà di LastUpdated„ nella Guida di DAO.
m_strSrcTableName
Specifica il nome di una tabella collegata se presente.Per direttamente recuperare il nome della tabella di origine, chiamare la funzione membro di GetSourceTableName dell'oggetto di CDaoTableDef associata alla tabella.
m_strConnect
Vengono fornite informazioni sul database di origine di un database aperto.È possibile controllare la proprietà chiamando la funzione membro di GetConnect dell'oggetto di CDaoTableDef .Per ulteriori informazioni sulla connessione delle stringhe, vedere GetConnect.
m_strValidationRule
Un valore per la convalida dei dati in TableDef sistema modificati o aggiunte a una tabella.La convalida è supportata solo per i database che utilizzano il modulo di gestione di database Microsoft Jet.Per direttamente recuperare la regola di convalida, chiamare la funzione membro di GetValidationRule dell'oggetto di CDaoTableDef associata alla tabella.Per informazioni correlate, vedere l'argomento “proprietà di ValidationRule„ nella Guida di DAO.
m_strValidationText
Un valore che specifica il testo del messaggio che l'applicazione deve essere visualizzata se la regola di convalida specificata dalla proprietà di ValidationRule non viene soddisfatta.Per informazioni correlate, vedere l'argomento “proprietà di ValidationText„ nella Guida di DAO.
m_lRecordCount
Il numero di record eseguito in un oggetto di TableDef.Questa impostazione delle proprietà è di sola lettura.Per direttamente recuperare il numero di record, chiamare la funzione membro di GetRecordCount dell'oggetto di CDaoTableDef .La documentazione per GetRecordCount indica il numero di record ulteriormente.Si noti che recupera questo conteggio può essere un'operazione dispendiosa in termini di tempo se la tabella contiene molti record.

Note

Il TableDef è un oggetto di classe CDaoTableDef.I riferimenti a primario, a secondario e tutti su indicano come le informazioni restituite dalla funzione membro di GetTableDefInfo nella classe CDaoDatabase.

Le informazioni recuperate dalla funzione membro di CDaoDatabase::GetTableDefInfo vengono archiviate in una struttura di CDaoTableDefInfo .Chiamare la funzione membro di GetTableDefInfo dell'oggetto di CDaoDatabase cui la raccolta di TableDef l'oggetto di TableDef viene archiviato.CDaoTableDefInfo definisce anche una funzione membro di Dump nelle build di debug.È possibile utilizzare Dump per eseguire il dump del contenuto di un oggetto di CDaoTableDefInfo .

Le impostazioni di data e ora sono derivate dal computer su cui la tabella di base è stata creata o l'ultimo aggiornato.In un ambiente multiutente, gli utenti devono ottenere queste impostazioni direttamente dal file server per evitare le differenze nelle impostazioni delle proprietà di LastUpdated e di DateCreated.