Classe CDaoException

Rappresenta una condizione di eccezione generata da classi di database MFC basate su oggetti DAO (Data Access Object).

Sintassi

class CDaoException : public CException

Membri

Costruttori pubblici

Metodi pubblici

Membri dati pubblici

Osservazioni:

La classe include membri dati pubblici che è possibile usare per determinare la causa dell'eccezione. CDaoException gli oggetti vengono costruiti e generati da funzioni membro delle classi di database DAO.

È possibile accedere agli oggetti eccezione all'interno dell'ambito di un'espressione CATCH . È anche possibile generare CDaoException oggetti dal proprio codice con la funzione globale AfxThrowDaoException .

In MFC tutti gli errori DAO vengono espressi come eccezioni, di tipo CDaoException. Quando si intercetta un'eccezione di questo tipo, è possibile utilizzare CDaoException le funzioni membro per recuperare informazioni da qualsiasi oggetto errore DAO archiviato nell'insieme Errors del motore di database. Quando si verifica ogni errore, nell'insieme Errors vengono inseriti uno o più oggetti errore. In genere la raccolta contiene un solo oggetto errore. Se si usa un'origine dati ODBC, è più probabile che vengano visualizzati più oggetti di errore. Quando un'altra operazione DAO genera un errore, l'insieme Errors viene cancellato e il nuovo oggetto errore viene inserito nell'insieme Errors. Le operazioni DAO che non generano un errore non hanno alcun effetto sulla raccolta Errors.

Per i codici di errore DAO, vedere il file DAOERR.H. Per informazioni correlate, vedere l'argomento "Errori di accesso ai dati intercegnabili" nella Guida di DAO.

Per altre informazioni sulla gestione delle eccezioni in generale o sugli CDaoException oggetti, vedere gli articoli Gestione delle eccezioni (MFC) ed Eccezioni: Eccezioni del database. Il secondo articolo contiene codice di esempio che illustra la gestione delle eccezioni in DAO.

Gerarchia di ereditarietà

CObject

CException

CDaoException

Requisiti

Intestazione: afxdao.h

CDaoException::CDaoException

Costruisce un oggetto CDaoException.

CDaoException();

Osservazioni:

In genere, il framework crea oggetti eccezione quando il codice genera un'eccezione. Raramente è necessario costruire un oggetto eccezione in modo esplicito. Se si vuole generare un oggetto CDaoException dal proprio codice, chiamare la funzione globale AfxThrowDaoException.

Tuttavia, è possibile creare in modo esplicito un oggetto eccezione se si effettuano chiamate dirette a DAO tramite i puntatori di interfaccia DAO incapsulati dalle classi MFC. In tal caso, potrebbe essere necessario recuperare informazioni sugli errori da DAO. Si supponga che si verifichi un errore in DAO quando si chiama un metodo DAO tramite l'interfaccia DAODatabases alla raccolta Databases di un'area di lavoro.

Per recuperare le informazioni sull'errore DAO

1. Costruire un CDaoException oggetto .

2. Chiamare la funzione membro GetErrorCount dell'oggetto eccezione per determinare il numero di oggetti errore presenti nell'insieme Errors del motore di database. In genere solo una, a meno che non si usi un'origine dati ODBC.

3. Chiamare la funzione membro GetErrorInfo dell'oggetto eccezione per recuperare un oggetto errore specifico alla volta, in base all'indice nell'insieme, tramite l'oggetto eccezione. Si consideri l'oggetto eccezione come proxy per un oggetto errore DAO.

4. Esaminare la struttura CDaoErrorInfo corrente che GetErrorInfo restituisce nel membro dati m_pErrorInfo. I relativi membri forniscono informazioni sull'errore DAO.

5. Nel caso di un'origine dati ODBC, ripetere i passaggi 3 e 4 in base alle esigenze per più oggetti di errore.

6. Se è stato creato l'oggetto eccezione nell'heap, eliminarlo con l'operatore delete al termine.

Per altre informazioni sulla gestione degli errori nelle classi DAO MFC, vedere l'articolo Eccezioni: Eccezioni al database.

CDaoException::GetErrorCount

Chiamare questa funzione membro per recuperare il numero di oggetti errore DAO nell'insieme Errors del motore di database.

short GetErrorCount();

Valore restituito

Numero di oggetti errore DAO nell'insieme Errors del motore di database.

Osservazioni:

Queste informazioni sono utili per scorrere l'insieme Errors per recuperare ognuno di uno o più oggetti errore DAO nell'insieme. Per recuperare un oggetto errore per indice o per numero di errore DAO, chiamare la funzione membro GetErrorInfo .

CDaoException::GetErrorInfo

Restituisce informazioni sull'errore relative a un oggetto errore specifico nell'insieme Errors.

void GetErrorInfo(int nIndex);

Parametri

nIndex
Indice delle informazioni sull'errore nella raccolta Errors del motore di database, per la ricerca in base all'indice.

Osservazioni:

Chiamare questa funzione membro per ottenere i tipi di informazioni seguenti sull'eccezione:

• Codice errore

• Origine

• Descrizione

• File della Guida

• Contesto della Guida

GetErrorInfo archivia le informazioni nel membro dati dell'oggetto m_pErrorInfo eccezione. Per una breve descrizione delle informazioni restituite, vedere m_pErrorInfo. Se si intercetta un'eccezione di tipo CDaoException generata da MFC, il m_pErrorInfo membro verrà già compilato. Se si sceglie di chiamare direttamente DAO, è necessario chiamare manualmente la funzione membro dell'oggetto GetErrorInfo eccezione per riempire m_pErrorInfo. Per una descrizione più dettagliata, vedere la struttura CDaoErrorInfo .

Per informazioni sulle eccezioni DAO e sul codice di esempio, vedere l'articolo Eccezioni: Eccezioni al database.

CDaoException::m_nAfxDaoError

Contiene un codice di errore esteso MFC.

Osservazioni:

Questo codice viene fornito nei casi in cui si è verificato un errore in un componente specifico delle classi DAO MFC.

I valori possibili sono:

• NO_AFX_DAO_ERROR L'operazione più recente non ha generato un errore esteso MFC. Tuttavia, l'operazione potrebbe aver generato altri errori da DAO o OLE, pertanto è consigliabile controllare m_pErrorInfo ed eventualmente m_scode.

• AFX_DAO_ERROR_ENGINE_INITIALIZATION MFC non è riuscito a inizializzare il motore di database Microsoft Jet. Ole potrebbe non essere riuscito a inizializzare oppure potrebbe essere stato impossibile creare un'istanza dell'oggetto motore di database DAO. Questi problemi suggeriscono in genere un'installazione non valida di DAO o OLE.

• AFX_DAO_ERROR_DFX_BIND Un indirizzo usato in una chiamata di funzione DFX (DAO Record Field Exchange) non esiste o non è valido (l'indirizzo non è stato usato per associare i dati). Potrebbe essere stato passato un indirizzo non valido in una chiamata DFX oppure l'indirizzo potrebbe non essere valido tra le operazioni DFX.

• AFX_DAO_ERROR_OBJECT_NOT_OPEN Si è tentato di aprire un recordset basato su un oggetto querydef o tabledef che non si trova in uno stato aperto.

CDaoException::m_pErrorInfo

Contiene un puntatore a una CDaoErrorInfo struttura che fornisce informazioni sull'oggetto errore DAO recuperato per l'ultima volta chiamando GetErrorInfo.

Osservazioni:

Questo oggetto contiene le informazioni seguenti:

Per informazioni dettagliate sulle informazioni contenute nell'oggetto CDaoErrorInfo , vedere la struttura CDaoErrorInfo .

CDaoException::m_scode

Contiene un valore di tipo SCODE che descrive l'errore.

Osservazioni:

Si tratta di un codice OLE. Raramente è necessario usare questo valore perché, in quasi tutti i casi, le informazioni sugli errori MFC o DAO più specifiche sono disponibili negli altri CDaoException membri dati.

Per informazioni su SCODE, vedere l'argomento Struttura dei codici di errore OLE in Windows SDK. Il tipo di dati SCODE esegue il mapping al tipo di dati HRESULT.

Vedi anche

Classe CException
Grafico della gerarchia