OracleException Classe

Referência

Definição

Namespace:: System.Data.OracleClient

Assembly:: System.Data.OracleClient.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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 : 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

Herança: Object

Exception

SystemException
OracleException

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()	Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception)
ToString()	Retorna uma cadeia de caracteres que contém o HRESULT do erro. (Herdado de ExternalException)

Eventos

SerializeObjectState

Obsoleto.

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)

Aplica-se a

Compartilhar via