Il Modello ad Oggetti di ADO - Errors ed Error

Home Page Commento dell'autore Articoli Le FAQ I documenti La ricerca Contribuire

A cura di:
Davide Bianchi
ADO è l'interfaccia più usata per accedere ai database sotto Windows, non solo mediante ASP, ma anche mediante Visual Basic, C/C++ ed altri ambienti di sviluppo.

Errors

Proprietà
Count

Metodi
Item, Clear

L'insieme Errors contiene tutti gli oggetti Error generati in seguito a un singolo errore relativo al provider.

Osservazioni
Qualsiasi operazione che implica l'utilizzo di oggetti ADO può generare uno o più errori di provider. Quando si verificano gli errori, uno o più oggetti Error vengono posizionati nell'insieme Errors della Connection. Quando un'altra operazione ADO genera un errore, l'insieme Errors viene cancellato e il nuovo set di oggetti Error viene posizionato.

Ciascun oggetto Error rappresenta un errore di provider specifico e non un errore ADO. Questi ultimi sono sottoposti al meccanismo di gestione delle eccezioni in fase di esecuzione. Se in Microsoft Visual Basic si verifica ad esempio un errore specifico ADO, verrà avviato un evento On Error e l'errore verrà visualizzato nell'oggetto Err.

Le operazioni ADO che non generano errori non hanno alcun effetto sull'insieme Errors. Utilizzare Clear per cancellare manualmente l'insieme.

Il set di oggetti Error dell'insieme descrive tutti gli errori verificatisi in seguito a un'istruzione singola. L'enumerazione degli errori specifici nell'insieme consente di eseguire routine di gestione degli errori per determinare con maggiore precisione la causa e l'origine di un errore e intraprendere le azioni appropriate per correggerlo.

Alcuni metodi e proprietà restituiscono avvisi visualizzati come oggetti Error nell'insieme senza tuttavia interrompere l'esecuzione di un programma. Prima di richiamare i metodi Resync, UpdateBatch o CancelBatch su un Recordset, il metodo Open su una Connection o impostare la proprietà Filter su un oggetto Recordset, richiamare Clear sull'insieme Errors per leggere la proprietà Count e verificare gli avvisi restituiti.

Nota
Per ulteriori informazioni sulla generazione di errori nel corso di un'operazione ADO, vedere l'argomento relativo all'oggetto Error.

Torna alla mappa

Proprietà

Count Indica il numero di oggetti contenuti nell'insieme. è una proprietà di sola lettura. Se il valore restituito è pari a 0, l'insieme è vuoto e non contiene nessun oggetto.

Nota:
La numerazione degli oggetti nell'insieme parte da 0 e non da 1.

Metodi

Item Restituisce un elemento specifico dall'insieme in base al nome o al suo numero ordinale.

Sintassi


oggetto = Errors.Item( indice )
oggetto rappresenta l'oggetto Error che verrà restituito.
indice è il nome o il numero dell'oggetto Error da reperire.

Osservazioni
Utilizzare questo metodo per reperire un oggetto dall'insieme e poterne poi interrogare le proprietà per conoscere i dettagli dell'errore verificatosi. Se non è possibile trovare nell'insieme l'oggetto corrispondente ad indice. si verificherà un errore.

Item è il metodo predefinito per tutti gli insiemi, quindi è possibile riferirsi a questo metodo anche con la sintassi semplificata


oggetto = Errors( indice )
Clear Rimuove tutti gli oggetti contenuti nell'insieme.
Utilizzare questo metodo per ripulire l'insieme prima di eseguire operazioni che potrebbero generare errori o durante le operazioni di recupero di un errore in modo controllato.

Sintassi


Errors.Clear
Error

Proprietà
Description, NativeError, Number, Source, SQLState

Metodi
L'oggetto Error non ha metodi.

Un oggetto Error contiene dettagli sugli errori di accesso ai dati relativi a una singola operazione che coinvolge il driver.

È possibile leggere le proprietà dell'oggetto Error per ottenere informazioni specifiche su ciascun errore, tra cui:

  • Description contiene il testo dell'errore.
  • Number contiene il valore numerico assegnato all'errore dal driver
  • Source identifica l'oggetto che ha riportato l'errore. Questa proprietà è particolarmente utile quando si dispone di più oggetti Error nell'insieme Errors in seguito a una richiesta su una fonte dati.
  • SQLState e NativeError, che forniscono informazioni dalle fonti dati SQL.
Un errore di provider rilevato viene posizionato nell'insieme Errors dell'oggetto Connection. ADO supporta la restituzione di più errori da parte di una singola operazione ADO per consentire la creazione di informazioni sull'errore specifiche del provider. Per ottenere queste informazioni complete sull'errore in un gestore di errori, utilizzare le funzioni di intercettazione degli errori appropriate per il linguaggio o l'ambiente operativo, quindi utilizzare i cicli nidificati per enumerare le proprietà di ciascun oggetto Error presente nell'insieme Errors.

Microsoft Visual Basic e VBScript
se non è disponibile un oggetto Connection. valido, sarà necessario recuperare le informazioni sull'errore dall'oggetto Err. Allo stesso modo dei provider, ADO cancella l'oggetto OLE Error Info prima di eseguire una chiamata che potrebbe generare un nuovo errore di provider. L'insieme Errors sull'oggetto Connection. viene tuttavia cancellato e compilato solo quando il provider genera un nuovo errore o quando viene richiamato il metodo Clear.

Torna alla mappa

Proprietà

Description Restituisce una stringa che descrive l'errore verificatosi.

Osservazioni
Questa proprietà consente di ottenere una breve descrizione dell'errore. Visualizzare questa proprietà per avvertire l'utente di un errore che non è possibile gestire. La stringa verrà fornita da ADO o dal driver interessato.

NativeError Ritorna il codice di errore specifico del driver.

Osservazioni
Utilizzare questa proprietà per recuperare le informazioni sull'errore specifico del database. Quando si utilizza Microsoft ODBC Provider for OLE DB con un database Microsoft® SQL Server, i codici di errore nativi provenienti dal server SQL passano attraverso ODBC e ODBC Provider alla proprietà NativeErrorNativeError di ADO.

Number Indica il numero che identifica in modo univoco un oggetto Error.

Osservazioni
Utilizzare questa proprietà per determinare il tipo di errore verificatosi. Il valore della proprietà è un numero univoco che corrisponde alla condizione di errore.

Source Indica il nome dell'oggetto o dell'applicazione che in origine ha generato un errore.

Osservazioni
Source viene utilizzata su un oggetto Error per determinare il nome dell'oggetto o dell'applicazione che in origine ha generato un errore, come ad esempio un nome di classe o l'ID programmatico dell'oggetto. Per gli errori in ADODB il valore della proprietà sarà ADODB.NomeOggetto, dove NomeOggetto è il nome dell'oggetto che ha generato l'errore.

Sulla base delle informazioni relative agli errori fornite dalle proprietà Source, Number e Description degli oggetti Error è possibile creare un codice in grado di gestire l'errore in modo appropriato.

SQLState Indica lo stato SQL per l'oggetto Error, lo stato viene restituito come una stringa di 5 caratteri basata sullo standard SQL ANSI.

Osservazioni
La proprietà SQLState viene utilizzata per leggere il codice di errore a cinque caratteri restituito dal provider in seguito a un errore verificatosi durante l'elaborazione di un'istruzione SQL. Quando ad esempio si utilizza il provider Microsoft OLE DB Provider per ODBC con un database Microsoft® SQL Server, i codici di errore vengono generati da ODBC sulla base di errori specifici di ODBC o di quelli generati da Microsoft SQL Server e vengono quindi convertiti in errori ODBC. Tali codici di errore sono documentati nello standard SQL ANSI, ma vengono implementati in modo diverso a seconda delle fonti dati utilizzate.


L'autore Davide Bianchi, pomposamente definito Software Engineer dal biglietto da visita, lavora per la Square bv, società olandese con sede a Roermond, che si occupa di sviluppo di software con orientamento grafico. Attualmente stà lavorando in Java (e si diverte un sacco).

Contribuire
Hai dei documenti interessanti o utili che trattano argomenti legati al mondo dell'informatica da pubblicare ? leggi come.
Come giudichi questo Documento ?
Hai trovato questo documento utile? inutile? interessante? noioso? fammelo sapere
Copyright Il presente sito è frutto del sudore della mia fronte (e delle mie dita), se siete interessati a ripubblicare uno degli articoli, documenti o qualunque altra cosa presente in questo sito per cortesia datemene comunicazione, così il giorno che faccio delle aggiunte potrò avvisarvi e magari mandarvi il testo aggiornato.

Questo sito è composto interamente con Ultraeditor.
Ultimo aggiornamento: 16 Luglio 2000