Struttura CDaoTableDefInfo

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

Sintassi

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
Denomina in modo univoco l'oggetto tabledef. Per recuperare direttamente il valore di questa proprietà, chiamare la funzione membro GetName dell'oggetto tabledef. Per altre informazioni, vedere l'argomento "Proprietà nome" nella Guida di DAO.

m_bUpdatable
Indica se è possibile apportare modifiche alla tabella. Il modo rapido per determinare se una tabella è aggiornabile consiste nell'aprire un CDaoTableDef oggetto per la tabella e chiamare la funzione membro CanUpdate dell'oggetto. CanUpdate restituisce sempre un valore diverso da zero (TRUE) per un oggetto tabledef appena creato e 0 (FALSE) per un oggetto tabledef associato. È possibile accodare un nuovo oggetto tabledef solo a un database per il quale l'utente corrente dispone dell'autorizzazione di scrittura. Se la tabella contiene solo campi non aggiornabili, CanUpdate restituisce 0. Quando uno o più campi sono aggiornabili, CanUpdate restituisce un valore diverso da zero. È possibile modificare solo i campi aggiornabili. Per altre informazioni, vedere l'argomento "Proprietà aggiornabile" nella Guida di DAO.

m_lAttributes
Specifica le caratteristiche della tabella rappresentata dall'oggetto tabledef. Per recuperare gli attributi correnti di un tabledef, chiamare la relativa funzione membro GetAttributes . Il valore restituito può essere una combinazione di queste costanti lunghe (usando l'operatore OR| bit per bit):

• dbAttachExclusive Per i database che utilizzano il motore di database Microsoft Jet, indica che la tabella è una tabella associata aperta per l'uso esclusivo.

• dbAttachSavePWD Per i database che utilizzano il motore di database Microsoft Jet, indica che l'ID utente e la password per la tabella associata vengono salvati con le informazioni di connessione.

• dbSystemObject Indica che la tabella è una tabella di sistema fornita dal motore di database Microsoft Jet. (sola lettura).

• dbHiddenObject Indica che la tabella è una tabella nascosta fornita dal motore di database Microsoft Jet (per l'uso temporaneo). (sola lettura).

• dbAttachedTable Indica che la tabella è una tabella collegata da un database non ODBC, ad esempio un database Paradox.

• dbAttachedODBC Indica che la tabella è una tabella collegata da un database ODBC, ad esempio Microsoft SQL Server.

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

m_dateLastUpdated
Data e ora della modifica più recente apportata alla struttura della tabella. Per recuperare direttamente la data dell'ultimo aggiornamento della tabella, chiamare la funzione membro GetDateLastUpdated dell'oggetto CDaoTableDef associato alla tabella. Per altre informazioni, vedere Commenti di seguito. Per informazioni correlate, vedere l'argomento "DateCreated, LastUpdated Properties" nella Guida di DAO.

m_strSrcTableName
Specifica il nome di una tabella associata, se presente. Per recuperare direttamente il nome della tabella di origine, chiamare la funzione membro GetSourceTableName dell'oggetto CDaoTableDef associato alla tabella.

m_strConnect
Fornisce informazioni sull'origine di un database aperto. È possibile controllare questa proprietà chiamando la funzione membro GetConnect dell'oggetto CDaoTableDef . Per altre informazioni sulle stringhe di connessione, vedere GetConnect.

m_strValidationRule
Valore che convalida i dati nei campi tabledef man mano che vengono modificati o aggiunti a una tabella. La convalida è supportata solo per i database che usano il motore di database Microsoft Jet. Per recuperare direttamente la regola di convalida, chiamare la funzione membro GetValidationRule dell'oggetto CDaoTableDef associato alla tabella. Per informazioni correlate, vedere l'argomento "ValidationRule Property" nella Guida di DAO.

m_strValidationText
Valore che specifica il testo del messaggio che l'applicazione deve visualizzare se la regola di convalida specificata dalla proprietà ValidationRule non è soddisfatta. Per informazioni correlate, vedere l'argomento "Proprietà ValidationText" nella Guida di DAO.

m_lRecordCount
Numero di record a cui si accede in un oggetto tabledef. Questa impostazione di proprietà è di sola lettura. Per recuperare direttamente il conteggio dei record, chiamare la funzione membro GetRecordCount dell'oggetto CDaoTableDef . La documentazione per GetRecordCount descrive ulteriormente il conteggio dei record. Si noti che il recupero di questo conteggio può richiedere molto tempo se la tabella contiene molti record.

Osservazioni:

Tabledef è un oggetto della classe CDaoTableDef. I riferimenti a Primary, Secondary e All sopra indicano come le informazioni vengono restituite dalla funzione membro GetTableDefInfo nella classe CDaoDatabase.

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

Le impostazioni di data e ora derivano dal computer in cui è stata creata o aggiornata la tabella di base. In un ambiente multiutente, gli utenti devono ottenere queste impostazioni direttamente dal file server per evitare discrepanze nelle impostazioni della proprietà DateCreated e LastUpdated.

Requisiti

Intestazione: afxdao.h

Vedi anche

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