OracleException Clase

Definición

Espacio de nombres:

System.Data.OracleClient

Ensamblado:

System.Data.OracleClient.dll

Excepción que se genera cuando una base de datos de Oracle o el proveedor de datos de .NET Framework para Oracle devuelve una advertencia o un error. Esta clase no puede heredarse.

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

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

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

Public NotInheritable Class OracleException
Inherits DbException

Herencia

Object

Exception

SystemException

ExternalException

DbException

OracleException

Atributos

SerializableAttribute

Ejemplos

En el ejemplo siguiente se genera una OracleException excepción debido a una base de datos que falta y, a continuación, se muestra la excepción.

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

Comentarios

Esta clase se crea cada vez que OracleDataAdapter encuentra una situación que no puede controlar.

Si la gravedad del error es demasiado grande, el servidor puede cerrar OracleConnection. Sin embargo, el usuario puede volver a abrir la conexión y continuar.

Propiedades

BatchCommand	Si se produjo al DbException ejecutar un DbBatch, hace referencia al específico DbBatchCommand que desencadenó la excepción. (Heredado de DbException)
Code	Obtiene la parte de código del error en forma de entero.
Data	Obtiene una colección de pares clave/valor que proporciona información definida por el usuario adicional sobre la excepción. (Heredado de Exception)
DbBatchCommand	Cuando se invalida en una clase derivada, si se produjo al DbException ejecutar un DbBatch, hace referencia al específico DbBatchCommand que desencadenó la excepción. (Heredado de DbException)
ErrorCode	Obtiene el elemento HRESULT del error. (Heredado de ExternalException)
HelpLink	Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción. (Heredado de Exception)
HResult	Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica. (Heredado de Exception)
InnerException	Obtiene la instancia Exception que produjo la excepción actual. (Heredado de Exception)
IsTransient	Indica si el error representado por esta DbException podría ser un error transitorio, es decir, si volver a intentar la operación de desencadenamiento podría realizarse correctamente sin ningún otro cambio. (Heredado de DbException)
Message	Obtiene un mensaje que describe la excepción actual. (Heredado de Exception)
Source	Devuelve o establece el nombre de la aplicación o del objeto que generó el error. (Heredado de Exception)
SqlState	Para los proveedores de bases de datos que lo admiten, contiene un código de retorno SQL estándar de cinco caracteres que indica si la operación de base de datos se realizó correctamente o no. Los dos primeros caracteres representan la clase del código de devolución (por ejemplo, error, correcto), mientras que los tres últimos caracteres representan la subclase, lo que permite detectar escenarios de error en una base de datos portable. En el caso de los proveedores de bases de datos que no lo admitan o para escenarios de error inaplicables, contiene null. (Heredado de DbException)
StackTrace	Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas. (Heredado de Exception)
TargetSite	Obtiene el método que produjo la excepción actual. (Heredado de Exception)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetBaseException()	Cuando se invalida en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores. (Heredado de Exception)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Establece el objeto SerializationInfo con información sobre la excepción.
GetType()	Obtiene el tipo de tiempo de ejecución de la instancia actual. (Heredado de Exception)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que contiene el HRESULT del error. (Heredado de ExternalException)

Eventos

SerializeObjectState

Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción. (Heredado de Exception)