Classe di CDaoDatabase

Rappresenta una connessione a un database tramite cui è possibile eseguire operazioni sui dati.

class CDaoDatabase : public CObject

Membri

34fa51ss.collapse_all(it-it,VS.110).gifCostruttori pubblici

Nome

Descrizione

CDaoDatabase::CDaoDatabase

Costruisce un oggetto CDaoDatabase.Chiamare Apri per connettere l'oggetto a un database.

34fa51ss.collapse_all(it-it,VS.110).gifMetodi pubblici

Nome

Descrizione

CDaoDatabase::CanTransact

Restituisce diverso da zero se le transazioni dei supporti del database.

CDaoDatabase::CanUpdate

Restituisce diverso da zero se l'oggetto CDaoDatabase è aggiornabile non di sola lettura).

CDaoDatabase::Close

Chiude la connessione di database.

CDaoDatabase::Create

Crea l'oggetto di database DAO sottostante e inizializza l'oggetto CDaoDatabase.

CDaoDatabase::CreateRelation

Definisce una nuova relazione tra le tabelle del database.

CDaoDatabase::DeleteQueryDef

Rimuove un oggetto di querydef salvato nella libreria di QueryDefs del database.

CDaoDatabase::DeleteRelation

Elimina una relazione esistente tra le tabelle del database.

CDaoDatabase::DeleteTableDef

Elimina la definizione di una tabella nel database.Ciò consente di eliminare la tabella e i relativi dati.

CDaoDatabase::Execute

Esegue una query di azione.Chiamando Execute per una query che restituisce i risultati genera un'eccezione.

CDaoDatabase::GetConnect

Restituisce la stringa di connessione utilizzata per connettere l'oggetto CDaoDatabase in un database.Utilizzato per ODBC.

CDaoDatabase::GetName

Restituisce l'oggetto attualmente il nome del database in uso.

CDaoDatabase::GetQueryDefCount

Restituisce il numero di query definiti per il database.

CDaoDatabase::GetQueryDefInfo

Restituisce informazioni su una query specificata definito nel database.

CDaoDatabase::GetQueryTimeout

Restituisce il numero di secondi dopo di che le operazioni di query di database saranno è scaduto.Aperto su qualsiasi successivo, aggiungere un nuovo, aggiornamento ed eliminazione di modifica e altre operazioni sulle origini dati ODBC (solo) come chiamate Execute.

CDaoDatabase::GetRecordsAffected

Restituisce il numero di record sull'ultimo aggiornamento, modifica, o aggiungere l'operazione o da una chiamata a Execute.

CDaoDatabase::GetRelationCount

Restituisce il numero delle relazioni definite tra le tabelle del database.

CDaoDatabase::GetRelationInfo

Restituisce informazioni su una relazione specificata definita tra le tabelle del database.

CDaoDatabase::GetTableDefCount

Restituisce il numero di tabelle definito nel database.

CDaoDatabase::GetTableDefInfo

Restituisce informazioni su una tabella specificata nel database.

CDaoDatabase::GetVersion

Restituisce la versione del motore di database associato al database.

CDaoDatabase::IsOpen

Restituisce diverso da zero se l'oggetto CDaoDatabase è attualmente connesso a un database.

CDaoDatabase::Open

Stabilisce una connessione a un database.

CDaoDatabase::SetQueryTimeout

Imposta il numero di secondi dopo di che le operazioni di query di database (nelle origini dati ODBC solo) è scaduto.Aperto su qualsiasi successivo, aggiungere un nuovo, di aggiornamento e di eliminazione.

34fa51ss.collapse_all(it-it,VS.110).gifMembri dati pubblici

Nome

Descrizione

CDaoDatabase::m_pDAODatabase

Un puntatore all'oggetto di database DAO sottostante.

CDaoDatabase::m_pWorkspace

Un puntatore all'oggetto CDaoWorkspace che contiene il database e definisce lo spazio delle transazioni.

Note

Per informazioni sui formati di database supportate, vedere la funzione membro GetName.È possibile avere più di uno o più oggetti CDaoDatabase per volta "in un'area di lavoro specificata," rappresentato da un oggetto CDaoWorkspace.L'area di lavoro gestisce una raccolta di oggetti di database aperti, chiamare la raccolta di database.

[!NOTA]

Le classi di database DAO MFC sono differenziate dalle classi di database MFC basate su ODBC.Tutti i nomi delle classi di database DAO dispongono del prefisso "di CDao".La classe CDaoDatabase fornisce un'interfaccia simile a quella della classe CDatabaseODBC.La differenza principale è che CDatabase accede al DBMS con ODBC (open database connectivity) e un driver ODBC per il DBMS.CDaoDatabase accede ai dati tramite un oggetto di accesso ai dati (DAO) in base al modulo di gestione di database Microsoft Jet.Le classi MFC basate su DAO risulta in genere più in grado delle classi MFC basate su ODBC, le classi basate su DAO possono accedere ai dati, ad esempio tramite driver ODBC, tramite proprio motore di database.Le classi basate su DAO supportano le operazioni di Data Definition Language (DDL), ad esempio aggiunta di tabelle tramite le classi, senza dover chiamare direttamente le API DAO.

Utilizzo

È possibile creare oggetti di database in modo implicito, quando si creano oggetti recordset.Ma è anche possibile creare oggetti di database in modo esplicito.Per utilizzare un database esistente in modo esplicito con CDaoDatabase, effettuare una delle operazioni seguenti:

  • Costruisce un oggetto CDaoDatabase, passando un puntatore a un oggetto aperto CDaoWorkspace.

  • O costruire un oggetto CDaoDatabase senza specificare l'area di lavoro (MFC crea un oggetto temporaneo dell'area di lavoro).

Per creare un nuovo database Microsoft Jet (.MDB), costruire un oggetto CDaoDatabase e chiamare la funzione membro Crea.Non chiamare Apri dopo Crea.

Per aprire un database esistente, costruire un oggetto CDaoDatabase e chiamare la funzione membro Apri.

Queste tecniche aggiunge l'oggetto di database DAO a database raccolta dell'area di lavoro e apre una connessione ai dati.Quando si costruisce oggetti CDaoRecordset, CDaoTableDef, o CDaoQueryDef da eseguire nel database collegato, passare ai costruttori per questi oggetti un puntatore all'oggetto CDaoDatabase.Dopo avere utilizzato la connessione, chiamare la funzione membro Chiudi ed eliminare l'oggetto CDaoDatabase.Chiudi chiude tutti i recordset che non sia stato chiuso in precedenza.

Transazioni

L'elaborazione delle transazioni di database è concessa a livello di area di lavoro (vedere le funzioni membro BeginTrans, CommitTranse Rollback di classe CDaoWorkspace.

Connessioni ODBC

La modalità consigliata per l'utilizzo di origini dati ODBC è di collegamento di tabelle esterne a un database Microsoft Jet (.MDB).

Raccolte

Ogni database gestisce le proprie raccolte di TableDef, di querydef, di recordset di oggetti e delle relazioni.La classe CDaoDatabase fornisce le funzioni membro per modificare questi oggetti.

[!NOTA]

Gli oggetti vengono archiviati in DAO, non nell'oggetto di database MFC.MFC fornisce classi per il TableDef, il tra e gli oggetti recordset ma non per gli oggetti della relazione.

Gerarchia di ereditarietà

CObject

CDaoDatabase

Requisiti

Header: afxdao.h

Vedere anche

Riferimenti

Classe di CObject

Grafico della gerarchia

Classe di CDaoWorkspace

Classe di CDaoRecordset

Classe di CDaoTableDef

Classe di CDaoQueryDef

Classe CDatabase

Classe di CDaoException