OleDbException Classe

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.dll

Eccezione generata quando il provider sottostante restituisce un avviso o un errore per un'origine dati OLE DB. La classe non può essere ereditata.

public ref class OleDbException sealed : System::Data::Common::DbException

[System.Serializable]
public sealed class OleDbException : System.Data.Common.DbException

[<System.Serializable>]
type OleDbException = class
    inherit DbException

Public NotInheritable Class OleDbException
Inherits DbException

Ereditarietà

Object

Exception

SystemException

ExternalException

DbException

OleDbException

Attributi

SerializableAttribute

Esempio

Nell'esempio seguente viene generato un oggetto OleDbException a causa di un'origine dati mancante e quindi viene visualizzata l'eccezione.

public void ShowOleDbException()
{
   string mySelectQuery = "SELECT column1 FROM table1";
   OleDbConnection myConnection =
      new OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;DataSource=");
   OleDbCommand myCommand = new OleDbCommand(mySelectQuery,myConnection);

   try
   {
      myCommand.Connection.Open();
   }
   catch (OleDbException e)
   {
     string errorMessages = "";

     for (int i=0; i < e.Errors.Count; i++)
     {
         errorMessages += "Index #" + i + "\n" +
                          "Message: " + e.Errors[i].Message + "\n" +
                          "NativeError: " + e.Errors[i].NativeError + "\n" +
                          "Source: " + e.Errors[i].Source + "\n" +
                          "SQLState: " + e.Errors[i].SQLState + "\n";
     }

     System.Diagnostics.EventLog log = new System.Diagnostics.EventLog();
     log.Source = "My Application";
     log.WriteEntry(errorMessages);
     Console.WriteLine("An exception occurred. Please contact your system administrator.");
   }
}

Public Sub ShowOleDbException()
    Dim mySelectQuery As String = "SELECT column1 FROM table1"
    Dim myConnection As New OleDbConnection _
       ("Provider=Microsoft.Jet.OLEDB.4.0;DataSource=")
    Dim myCommand As New OleDbCommand(mySelectQuery, myConnection)

    Try
        myCommand.Connection.Open()
    Catch e As OleDbException
        Dim errorMessages As String
        Dim i As Integer

        For i = 0 To e.Errors.Count - 1
            errorMessages += "Index #" & i.ToString() & ControlChars.Cr _
                           & "Message: " & e.Errors(i).Message & ControlChars.Cr _
                           & "NativeError: " & e.Errors(i).NativeError & ControlChars.Cr _
                           & "Source: " & e.Errors(i).Source & ControlChars.Cr _
                           & "SQLState: " & e.Errors(i).SQLState & ControlChars.Cr
        Next i

       Dim log As New System.Diagnostics.EventLog()
       log.Source = "My Application"
       log.WriteEntry(errorMessages)
       Console.WriteLine("An exception occurred. Please contact your system administrator.")
    End Try
End Sub

Commenti

Questa classe viene creata ogni volta che il framework di .NET provider di dati per OLE DB rileva un errore generato dal server. Gli errori lato client vengono generati come eccezioni standard di Common Language Runtime. OleDbException contiene sempre almeno un'istanza di OleDbError.

Se la gravità dell'errore è troppo grande, il server potrebbe chiudere .OleDbConnection Tuttavia, l'utente può riaprire la connessione e continuare.

Per informazioni generali sulla gestione delle eccezioni per un provider di dati di .NET Framework, vedere SqlException.

Proprietà

Nome	Descrizione
Data	Ottiene una raccolta di coppie chiave/valore che forniscono informazioni aggiuntive definite dall'utente sull'eccezione. (Ereditato da Exception)
ErrorCode	Ottiene il valore HRESULT dell'errore.
Errors	Ottiene un insieme di uno o più oggetti OleDbError che forniscono informazioni dettagliate sulle eccezioni generate dal provider di dati framework di .NET per OLE DB.
HelpLink	Ottiene o imposta un collegamento al file della Guida associato a questa eccezione. (Ereditato da Exception)
HResult	Ottiene o imposta HRESULT, valore numerico codificato assegnato a un'eccezione specifica. (Ereditato da Exception)
InnerException	Ottiene l'istanza Exception che ha causato l'eccezione corrente. (Ereditato da Exception)
Message	Ottiene un messaggio che descrive l'eccezione corrente. (Ereditato da Exception)
Source	Ottiene o imposta il nome dell'applicazione o dell'oggetto che causa l'errore. (Ereditato da Exception)
StackTrace	Ottiene una rappresentazione di stringa dei fotogrammi immediati nello stack di chiamate. (Ereditato da Exception)
TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaseException()	Quando sottoposto a override in una classe derivata, restituisce l'oggetto Exception che rappresenta la causa radice di una o più eccezioni successive. (Ereditato da Exception)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)	Questo membro esegue l'override di GetObjectData(SerializationInfo, StreamingContext).
GetType()	Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che contiene il valore HRESULT dell'errore. (Ereditato da ExternalException)

Eventi

Nome	Descrizione
SerializeObjectState	Si verifica quando viene serializzata un'eccezione per creare un oggetto stato dell'eccezione contenente dati serializzati sull'eccezione. (Ereditato da Exception)

Vedi anche

• OleDbErrorCollection
• Gestione e generazione di eccezioni in .NET