Classe CDaoTableDef

Articolo
06/10/2015

Rappresenta la definizione archiviata di una tabella di base o di una tabella collegata.

class CDaoTableDef : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CDaoTableDef::CDaoTableDef	Costruisce un oggetto CDaoTableDef .

Metodi pubblici

Nome	Descrizione
CDaoTableDef::Append	Aggiunge una nuova tabella nel database.
CDaoTableDef::CanUpdate	Restituisce diverso da zero se la tabella può essere aggiornata (possibile modificare la definizione di campi o proprietà tabella).
CDaoTableDef::Close	Chiude un TableDef aperto.
CDaoTableDef::Create	Crea una tabella che può essere aggiunto al database utilizzando Aggiungere.
CDaoTableDef::CreateField	Chiamato per creare un campo di una tabella.
CDaoTableDef::CreateIndex	Chiamato per creare un indice per una tabella.
CDaoTableDef::DeleteField	Chiamato per eliminare un campo di una tabella.
CDaoTableDef::DeleteIndex	Chiamato per eliminare un indice da una tabella.
CDaoTableDef::GetAttributes	Restituisce un valore che indica una o più funzionalità di un oggetto CDaoTableDef.
CDaoTableDef::GetConnect	Restituisce un valore che fornisce informazioni sull'origine di una tabella.
CDaoTableDef::GetDateCreated	Restituisce la data e l'ora nella tabella di base sottostante a un oggetto CDaoTableDef è stata creata.
CDaoTableDef::GetDateLastUpdated	Restituisce la data e ora di modifica più recente effettuata alla progettazione della tabella di base.
CDaoTableDef::GetFieldCount	Restituisce un valore che rappresenta il numero di campi nella tabella.
CDaoTableDef::GetFieldInfo	Restituisce tipi specifici di informazioni sui campi nella tabella.
CDaoTableDef::GetIndexCount	Restituisce il numero di indici per la tabella.
CDaoTableDef::GetIndexInfo	Restituisce tipi specifici di informazioni sugli indici per la tabella.
CDaoTableDef::GetName	Restituisce il nome definito dalla tabella.
CDaoTableDef::GetRecordCount	Restituisce il numero di record nella tabella.
CDaoTableDef::GetSourceTableName	Restituisce un valore che specifica il nome della tabella collegata nel database di origine.
CDaoTableDef::GetValidationRule	Restituisce un valore per la convalida dei dati in un campo quando viene modificato o aggiunto a una tabella.
CDaoTableDef::GetValidationText	Restituisce un valore che specifica il testo del messaggio che l'applicazione viene visualizzato se il valore di un oggetto di campo non soddisfa la regola di convalida specificata.
CDaoTableDef::IsOpen	Restituisce diverso da zero se la tabella viene aperta.
CDaoTableDef::Open	Apre un TableDef esistente archiviato nella libreria di TableDef del database.
CDaoTableDef::RefreshLink	Aggiorna le informazioni di connessione per una tabella collegata.
CDaoTableDef::SetAttributes	Imposta un valore che indica una o più funzionalità di un oggetto CDaoTableDef.
CDaoTableDef::SetConnect	Imposta un valore che fornisce informazioni sull'origine di una tabella.
CDaoTableDef::SetName	Imposta il nome della tabella.
CDaoTableDef::SetSourceTableName	Imposta un valore che specifica il nome di una tabella collegata nel database di origine.
CDaoTableDef::SetValidationRule	Imposta un valore che convalida i dati in un campo quando viene modificato o aggiunto a una tabella.
CDaoTableDef::SetValidationText	Imposta un valore che specifica il testo del messaggio che l'applicazione viene visualizzato se il valore di un oggetto di campo non soddisfa la regola di convalida specificata.

Membri dati pubblici

Nome	Descrizione
CDaoTableDef::m_pDAOTableDef	Un puntatore a un'interfaccia di DAO sottostante all'oggetto di TableDef.
CDaoTableDef::m_pDatabase	Origine di questa tabella.

Note

Ogni oggetto di database DAO gestisce una raccolta, chiamata TableDefs, che contiene tutti gli oggetti salvati di TableDef di DAO.

Modificare una definizione di tabella mediante un oggetto CDaoTableDef. Ad esempio, è possibile:

Esaminare la struttura di indice e del campo di una tabella locale, collegata, o esterna in un database.
Chiamare le funzioni membro SetSourceTableName e SetConnect per le tabelle collegate e utilizzare la funzione membro RefreshLink per aggiornare le connessioni alle tabelle collegate.
Chiamare la funzione membro CanUpdate per determinare se è possibile modificare le definizioni di campo della tabella.
Ottenere o impostare gli stati di convalida utilizzando GetValidationRule e SetValidationRulele funzioni membro e SetValidationText e GetValidationText.
Utilizzare la funzione membro Apri per creare una tabella, un dynaset, o un oggetto di tipo snapshot CDaoRecordset.

Nota

Le classi di database DAO sono differenziate dalle classi di database MFC basate su ODBC.Tutti i nomi delle classi di database DAO dispongono del prefisso "di CDao".È ancora possibile accedere alle origini dati ODBC con le classi DAO, le classi DAO presentano in genere le funzionalità principali perché sono specifiche del modulo di gestione di database Microsoft Jet.

Per utilizzare gli oggetti di TableDef con una tabella esistente o creare una nuova tabella

In tutti i casi, è necessario costruire un oggetto CDaoTableDef, fornendo un puntatore a un oggetto CDaoDatabase a cui appartiene la tabella.
Fare quanto segue, in cui si desidera:
- Per utilizzare un oggetto esistente ha salvato la tabella, chiama la funzione membro Apri dell'oggetto di TableDef, specificando il nome della tabella salvata.
- Per creare una nuova tabella, chiamare la funzione membro Crea dell'oggetto di TableDef, specificando il nome della tabella. Chiamare CreateField e CreateIndex per aggiungere campi e indici alla tabella.
- Chiamare Aggiungere per salvare la tabella accodandola a TableDef della raccolta. Crea inserisce il TableDef in stato aperto, pertanto dopo viene Crea che non si chiama Apri.
  
  Suggerimento
  
  Il modo più semplice per creare tabelle salvate è di crearli e archiviarle nel database utilizzando Microsoft Access.È quindi possibile aprirli e utilizzare nel codice MFC.

Per utilizzare l'oggetto di TableDef è aperto o creato, che creare e aprire un oggetto CDaoRecordset, specificando il nome del TableDef con un valore dbOpenTable nel parametro nOpenType.

Per utilizzare un oggetto di TableDef per creare un oggetto CDaoRecordset, in genere si crea o si apre un TableDef come descritto in precedenza, quindi si costruisce un oggetto recordset, passando un puntatore a un oggetto di TableDef quando si chiama CDaoRecordset::Open. Il TableDef passato sia in uno stato aperto. Per ulteriori informazioni, vedere la classe CDaoRecordset.

Dopo avere utilizzato un oggetto di TableDef, chiamare la funzione membro Chiudi ; quindi eliminare l'oggetto di TableDef.