OracleException Classe

Definição

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.The exception that is generated when a warning or error is returned by an Oracle database or the .NET Framework Data Provider for Oracle. Essa classe não pode ser herdada.This class cannot be inherited.

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
OracleException
Herança
Atributos

Exemplos

O exemplo a seguir gera um OracleException devido a um banco de dados ausente e, em seguida, exibe a exceção.The following example generates an OracleException due to a missing database, and then displays the exception.

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 OracleDataAdapter que o encontra uma situação que ele não pode manipular.This class is created whenever the OracleDataAdapter encounters a situation that it cannot handle.

Se a severidade do erro for muito grande, o servidor poderá fechar o OracleConnection.If the severity of the error is too great, the server may close the OracleConnection. No entanto, o usuário pode reabrir a conexão e continuar.However, the user can reopen the connection and continue.

Propriedades

Code

Obtém a parte de código do erro como um inteiro.Gets the code portion of the error as an integer.

Data

Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Herdado de Exception)
ErrorCode

Obtém o HRESULT do erro.Gets the HRESULT of the error.

(Herdado de ExternalException)
HelpLink

Obtém ou define um link para o arquivo de ajuda associado a essa exceção.Gets or sets a link to the help file associated with this exception.

(Herdado de Exception)
HResult

Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Herdado de Exception)
InnerException

Obtém a instância Exception que causou a exceção atual.Gets the Exception instance that caused the current exception.

(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.Indicates whether the error represented by this DbException could be a transient error, i.e. if retrying the triggering operation may succeed without any other change.

(Herdado de DbException)
Message

Obtém uma mensagem que descreve a exceção atual.Gets a message that describes the current exception.

(Herdado de Exception)
Source

Obtém ou define o nome do aplicativo ou objeto que causa o erro.Gets or sets the name of the application or the object that causes the error.

(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.For database providers which support it, contains a standard SQL 5-character return code indicating the success or failure of the database operation. 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.The first 2 characters represent the class of the return code (e.g. error, success), while the last 3 characters represent the subclass, allowing detection of error scenarios in a database-portable way.

Para provedores de banco de dados que não são compatíveis ou para cenários de erro inaplicáveis, contém null.For database providers which don't support it, or for inapplicable error scenarios, contains null.

(Herdado de DbException)
StackTrace

Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas.Gets a string representation of the immediate frames on the call stack.

(Herdado de Exception)
TargetSite

Obtém o método que gerou a exceção atual.Gets the method that throws the current exception.

(Herdado de Exception)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(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.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Herdado de Exception)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Define o SerializationInfo com informações sobre a exceção.Sets the SerializationInfo with information about the exception.

GetType()

Obtém o tipo de runtime da instância atual.Gets the runtime type of the current instance.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Cria e retorna uma representação de cadeia de caracteres da exceção atual.Creates and returns a string representation of the current exception.

(Herdado de Exception)
ToString()

Retorna uma cadeia de caracteres que contém o HRESULT do erro.Returns a string that contains the HRESULT of the error.

(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.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Herdado de Exception)

Aplica-se a