Classe CDatabase

Articolo
03/05/2013

Rappresenta una connessione a un'origine dati, con cui è possibile operare nell'origine dati.

class CDatabase : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CDatabase::CDatabase	Costruisce un oggetto CDatabase.È necessario inizializzare l'oggetto chiamando OpenEx o Apri.

Metodi pubblici

Nome	Descrizione
CDatabase::BeginTrans	Inizia "una transazione" — una serie di chiamate reversibili a AddNew, a Modifica, a Eliminae funzioni membro Aggiorna di classe CRecordset —origine dati collegata.L'origine dati deve supportare le transazioni per BeginTrans di qualsiasi effetto.
CDatabase::BindParameters	Consente ai parametri di correlazione prima di chiamare CDatabase::ExecuteSQL.
CDatabase::Cancel	Annulla un'operazione asincrona o un processo da un secondo thread.
CDatabase::CanTransact	Restituisce diverso da zero se l'origine dati supporta le transazioni.
CDatabase::CanUpdate	Restituisce diverso da zero se l'oggetto CDatabase è aggiornabile non di sola lettura).
CDatabase::Close	Chiude la connessione a un'origine dati.
CDatabase::CommitTrans	Completamento di una transazione avviata da BeginTrans.I controlli della transazione che modificano l'origine dati viene eseguito.
CDatabase::ExecuteSQL	Esegue un'istruzione SQL.Nessun record di dati restituiti.
CDatabase::GetBookmarkPersistence	Identifica le operazioni con cui i segnalibri persistenti sugli oggetti recordset.
CDatabase::GetConnect	Restituisce la stringa di connessione ODBC utilizzata per connettere l'oggetto CDatabase a un'origine dati.
CDatabase::GetCursorCommitBehavior	Identifica l'effetto del commit di una transazione in un oggetto recordset aperto.
CDatabase::GetCursorRollbackBehavior	Identifica l'effetto di annullamento una transazione in un oggetto recordset aperto.
CDatabase::GetDatabaseName	Restituisce l'oggetto attualmente il nome del database in uso.
CDatabase::IsOpen	Restituisce diverso da zero se l'oggetto CDatabase è attualmente connesso a un'origine dati.
CDatabase::OnSetOptions	Chiamato dal framework per impostare le opzioni di connessione standard.L'implementazione predefinita di impostare il valore di timeout delle query.È possibile impostare queste opzioni prima del tempo chiamando SetQueryTimeout.
CDatabase::Open	Stabilisce una connessione a un'origine dati (tramite un driver ODBC).
CDatabase::OpenEx	Stabilisce una connessione a un'origine dati (tramite un driver ODBC).
CDatabase::Rollback	Inverte di modifiche apportate durante una transazione corrente.Restituisce l'oggetto di origine dati allo stato precedente, come definito nella chiamata BeginTrans, invariata.
CDatabase::SetLoginTimeout	Imposta il numero di secondi dopo di che un tentativo di connessione all'origine dati è scaduto.
CDatabase::SetQueryTimeout	Imposta il numero di secondi dopo di che le operazioni di query di database saranno è scaduto.Influisce su qualsiasi recordset successivo Apri, AddNew, Modificae chiamate Elimina.

Membri dati pubblici

Nome	Descrizione
CDatabase::m_hdbc	Handle di connessione ODBC (open database connectivity) a un'origine dati.Tipo HDBC.

Note

Un'origine dati è un'istanza specifica dei dati memorizzati da un sistema di gestione di database (DBMS).Gli esempi includono dBASE di Microsoft SQL Server, Microsoft Access, di Borland e il xBASE.È possibile avere più di uno o più oggetti CDatabase contemporaneamente nell'applicazione.

[!NOTA]

Se si utilizzano gli oggetti di accesso ai dati che (DAO) classi anziché le classi ODBC (open database connectivity), la classe CDaoDatabase di utilizzare.Per ulteriori informazioni, vedere l'articolo cenni preliminari: La programmazione di database.

Per utilizzare CDatabase, costruire un oggetto CDatabase e chiamare la funzione membro OpenEx.Verrà aperta una connessione.Quando si costruisce oggetti CRecordset per funzionare nell'origine dati collegata, passare al costruttore del recordset un puntatore all'oggetto CDatabase.Dopo avere utilizzato la connessione, chiamare la funzione membro Chiudi ed eliminare l'oggetto CDatabase.Chiudi chiude tutti i recordset che non sia stato chiuso in precedenza.

Per ulteriori informazioni su CDatabase, vedere gli articoli origine dati (ODBC) e cenni preliminari: La programmazione di database.