OracleException Classe

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

A exceção gerada quando um aviso ou erro é retornado por um banco de dados Oracle ou pelo Provedor de Dados .NET Framework para Oracle. Essa classe não pode ser herdada.

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

Herança

Object

Exception

SystemException

ExternalException

DbException

OracleException

Atributos

SerializableAttribute

Exemplos

O exemplo a seguir gera um OracleException devido a um banco de dados ausente e exibe a exceção.

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

Comentários

Essa classe é criada sempre que o OracleDataAdapter encontra uma situação que não pode lidar.

Se a severidade do erro for muito grande, o servidor poderá fechar o OracleConnection. No entanto, o usuário pode reabrir a conexão e continuar.

Propriedades

BatchCommand	Se isso DbException tiver sido gerado ao executar um DbBatch, referencia o específico DbBatchCommand que disparou a exceção. (Herdado de DbException)
Code	Obtém a parte de código do erro como um inteiro.
Data	Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção. (Herdado de Exception)
DbBatchCommand	Quando substituído em uma classe derivada, se isso DbException tiver sido gerado ao executar um DbBatch, referencia o específico DbBatchCommand que disparou a exceção. (Herdado de DbException)
ErrorCode	Obtém o HRESULT do erro. (Herdado de ExternalException)
HelpLink	Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception)
HResult	Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception)
InnerException	Obtém a instância Exception que causou a exceção atual. (Herdado de Exception)
IsTransient	Indica se o erro representado pela DbException pode ser transitório, ou seja, se a repetição da operação de acionamento pode ter sucesso sem nenhuma outra alteração. (Herdado de DbException)
Message	Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception)
Source	Obtém ou define o nome do aplicativo ou objeto que causa o erro. (Herdado de Exception)
SqlState	Para provedores de banco de dados compatíveis, contém um código de retorno SQL padrão de 5 caracteres que indica o êxito ou a falha da operação de banco de dados. Os dois primeiros caracteres representam a classe do código de retorno (por exemplo, erro ou êxito), enquanto os três últimos caracteres representam a subclasse, permitindo a detecção de cenários de erro em uma forma portátil de banco de dados. Para provedores de banco de dados que não são compatíveis ou para cenários de erro inaplicáveis, contém null. (Herdado de DbException)
StackTrace	Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que gerou a exceção atual. (Herdado de Exception)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBaseException()	Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Define o SerializationInfo com informações sobre a exceção.
GetType()	Obtém o tipo de runtime da instância atual. (Herdado de Exception)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que contém o HRESULT do erro. (Herdado de ExternalException)

Eventos

SerializeObjectState

Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception)