OracleException Klasse

Referenz

Definition

Namespace:: System.Data.OracleClient

Assembly:: System.Data.OracleClient.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Die Ausnahme, die generiert wird, wenn eine Warnung oder ein Fehler von einer Oracle-Datenbank oder dem .NET Framework-Datenprovider für Oracle zurückgegeben wird. Diese Klasse kann nicht vererbt werden.

public ref class OracleException sealed : SystemException

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

[System.Serializable]
public sealed class OracleException : SystemException

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

[<System.Serializable>]
type OracleException = class
    inherit SystemException

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

Public NotInheritable Class OracleException
Inherits SystemException

Public NotInheritable Class OracleException
Inherits DbException

Vererbung: Object

Exception

SystemException
OracleException

Vererbung: Object

Exception

SystemException

ExternalException

DbException
OracleException

Attribute: SerializableAttribute

Beispiele

Im folgenden Beispiel wird eine OracleException aufgrund einer fehlenden Datenbank generiert und dann die Ausnahme angezeigt.

public void ShowOracleException()
{
   OracleConnection myConnection =
      new OracleConnection("Data Source=Oracle8i;Integrated Security=yes");

   try
   {
      myConnection.Open();
   }
   catch (OracleException e)
   {
     string errorMessage = "Code: " + e.Code + "\n" +
                           "Message: " + e.Message;

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

Public Sub ShowOracleException() 

   Dim myConnection As OracleConnection = _
      New OracleConnection("Data Source=Oracle8i;Integrated Security=yes")

   Try 

      myConnection.Open()

   Catch e As OracleException

     Dim errorMessage As String = "Code: " & e.Code & vbCrLf & _
                                  "Message: " & e.Message

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

   End Try
End Sub

Hinweise

Diese Klasse wird immer dann erstellt, wenn eine OracleDataAdapter Situation auftritt, die nicht verarbeitet werden kann.

Wenn die Auswirkungen des Fehlers zu schwerwiegend sind, trennt der Server möglicherweise die OracleConnection. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.

Eigenschaften

BatchCommand	Wenn dies DbException beim Ausführen eines DbBatchausgelöst wurde, verweist auf das Spezifische DbBatchCommand , das die Ausnahme ausgelöst hat. (Geerbt von DbException)
Code	Ruft den Codeteil des Fehlers als ganze Zahl ab.
Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception)
DbBatchCommand	Wenn dies DbException beim Überschreiben in einer abgeleiteten Klasse ausgelöst wurde, verweist DbBatchauf das Spezifische DbBatchCommand , das die Ausnahme ausgelöst hat. (Geerbt von DbException)
ErrorCode	Ruft das `HRESULT` des Fehlers ab. (Geerbt von ExternalException)
HelpLink	Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Geerbt von Exception)
HResult	Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Geerbt von Exception)
InnerException	Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception)
IsTransient	Gibt an, ob der Fehler, der von dieser DbException dargestellt wird, ein vorübergehender Fehler sein könnte, d. h., ob die Wiederholung des Auslösevorgangs ohne sonstige Änderung erfolgreich sein könnte. (Geerbt von DbException)
Message	Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird. (Geerbt von Exception)
Source	Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest. (Geerbt von Exception)
SqlState	Enthält für Datenbankanbieter, die dies unterstützen, einen standardmäßigen SQL 5-Zeichenrückgabecode, der angibt, ob der Datenbankvorgang erfolgreich war oder nicht. Die ersten 2 Zeichen stellen die Klasse des Rückgabecodes (z. B. Fehler, Erfolg) dar, während die letzten 3 Zeichen die Unterklasse darstellen und die Erkennung von Fehlerszenarios auf datenbankportierbare Weise ermöglichen. Für Datenbankanbieter, die dies nicht unterstützen, oder für nicht anwendbare Fehlerszenarios ist `null` enthalten. (Geerbt von DbException)
StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Geerbt von Exception)
TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBaseException()	Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist. (Geerbt von Exception)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Legt SerializationInfo mit Informationen zur Ausnahme fest.
GetType()	Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück. (Geerbt von Exception)
ToString()	Gibt eine Zeichenfolge zurück, die das HRESULT des Fehlers enthält. (Geerbt von ExternalException)

Ereignisse

SerializeObjectState

Veraltet.

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.

(Geerbt von Exception)

Gilt für: