OleDbException Clase

Definición

Excepción que se produce cuando el proveedor subyacente devuelve una advertencia o un error para un origen de datos de OLE DB.The exception that is thrown when the underlying provider returns a warning or error for an OLE DB data source. Esta clase no puede heredarse.This class cannot be inherited.

public ref class OleDbException sealed : System::Data::Common::DbException
public ref class OleDbException sealed : System::Runtime::InteropServices::ExternalException
public sealed class OleDbException : System.Data.Common.DbException
[System.Serializable]
public sealed class OleDbException : System.Runtime.InteropServices.ExternalException
[System.Serializable]
public sealed class OleDbException : System.Data.Common.DbException
type OleDbException = class
    inherit DbException
[<System.Serializable>]
type OleDbException = class
    inherit ExternalException
[<System.Serializable>]
type OleDbException = class
    inherit DbException
Public NotInheritable Class OleDbException
Inherits DbException
Public NotInheritable Class OleDbException
Inherits ExternalException
Herencia
OleDbException
Herencia
Herencia
Atributos

Ejemplos

En el ejemplo siguiente se genera un OleDbException debido a que falta un origen de datos y, a continuación, se muestra la excepción.The following example generates an OleDbException because of a missing data source, and then displays the exception.

public void ShowOleDbException()
{
   string mySelectQuery = "SELECT column1 FROM table1";
   OleDbConnection myConnection =
      new OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;DataSource=");
   OleDbCommand myCommand = new OleDbCommand(mySelectQuery,myConnection);

   try
   {
      myCommand.Connection.Open();
   }
   catch (OleDbException e)
   {
     string errorMessages = "";

     for (int i=0; i < e.Errors.Count; i++)
     {
         errorMessages += "Index #" + i + "\n" +
                          "Message: " + e.Errors[i].Message + "\n" +
                          "NativeError: " + e.Errors[i].NativeError + "\n" +
                          "Source: " + e.Errors[i].Source + "\n" +
                          "SQLState: " + e.Errors[i].SQLState + "\n";
     }

     System.Diagnostics.EventLog log = new System.Diagnostics.EventLog();
     log.Source = "My Application";
     log.WriteEntry(errorMessages);
     Console.WriteLine("An exception occurred. Please contact your system administrator.");
   }
}
Public Sub ShowOleDbException()
    Dim mySelectQuery As String = "SELECT column1 FROM table1"
    Dim myConnection As New OleDbConnection _
       ("Provider=Microsoft.Jet.OLEDB.4.0;DataSource=")
    Dim myCommand As New OleDbCommand(mySelectQuery, myConnection)

    Try
        myCommand.Connection.Open()
    Catch e As OleDbException
        Dim errorMessages As String
        Dim i As Integer

        For i = 0 To e.Errors.Count - 1
            errorMessages += "Index #" & i.ToString() & ControlChars.Cr _
                           & "Message: " & e.Errors(i).Message & ControlChars.Cr _
                           & "NativeError: " & e.Errors(i).NativeError & ControlChars.Cr _
                           & "Source: " & e.Errors(i).Source & ControlChars.Cr _
                           & "SQLState: " & e.Errors(i).SQLState & ControlChars.Cr
        Next i

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

Comentarios

Esta clase se crea cada vez que el proveedor de datos de .NET Framework para OLE DB encuentra un error generado desde el servidor.This class is created whenever the .NET Framework Data Provider for OLE DB encounters an error generated from the server. (Los errores del lado cliente se producen como excepciones de Common Language Runtime estándar). OleDbException siempre contiene al menos una instancia de OleDbError .(Client side errors are thrown as standard common language runtime exceptions.) OleDbException always contains at least one instance of OleDbError.

Si la gravedad del error es demasiado grande, el servidor puede cerrar OleDbConnection.If the severity of the error is too great, the server may close the OleDbConnection. Sin embargo, el usuario puede volver a abrir la conexión y continuar.However, the user can reopen the connection and continue.

Para obtener información general sobre el control de excepciones para un proveedor de datos de .NET Framework, vea SqlException .For general information about handling exceptions for a .NET Framework data provider, see SqlException.

Propiedades

Data

Obtiene una colección de pares clave/valor que proporciona información definida por el usuario adicional sobre la excepción.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Heredado de Exception)
ErrorCode

Obtiene el HRESULT del error.Gets the HRESULT of the error.

Errors

Obtiene una colección de uno o varios objetos OleDbError que ofrecen información detallada sobre las excepciones que genera el proveedor de datos de .NET Framework para OLE DB.Gets a collection of one or more OleDbError objects that give detailed information about exceptions generated by the .NET Framework Data Provider for OLE DB.

HelpLink

Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción.Gets or sets a link to the help file associated with this exception.

(Heredado de Exception)
HResult

Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Heredado de Exception)
InnerException

Obtiene la instancia Exception que produjo la excepción actual.Gets the Exception instance that caused the current exception.

(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.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.

(Heredado de DbException)
Message

Obtiene el texto que describe el error.Gets the text describing the error.

Message

Obtiene un mensaje que describe la excepción actual.Gets a message that describes the current exception.

(Heredado de Exception)
Source

Obtiene el nombre del proveedor OLE DB que ha generado el error.Gets the name of the OLE DB provider that generated the error.

Source

Devuelve o establece el nombre de la aplicación o del objeto que generó el error.Gets or sets the name of the application or the object that causes the 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.For database providers which support it, contains a standard SQL 5-character return code indicating the success or failure of the database operation. 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.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.

En el caso de los proveedores de bases de datos que no lo admitan o para escenarios de error inaplicables, contiene null.For database providers which don't support it, or for inapplicable error scenarios, contains null.

(Heredado de DbException)
StackTrace

Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas.Gets a string representation of the immediate frames on the call stack.

(Heredado de Exception)
TargetSite

Obtiene el método que produjo la excepción actual.Gets the method that throws the current exception.

(Heredado de Exception)

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

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

(Heredado de Exception)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Este miembro invalida GetObjectData(SerializationInfo, StreamingContext).This member overrides GetObjectData(SerializationInfo, StreamingContext).

GetType()

Obtiene el tipo de tiempo de ejecución de la instancia actual.Gets the runtime type of the current instance.

(Heredado de Exception)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Crea y devuelve una representación de cadena de la excepción actual.Creates and returns a string representation of the current exception.

(Heredado de Exception)
ToString()

Devuelve una cadena que contiene el HRESULT del error.Returns a string that contains the HRESULT of the 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.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Heredado de Exception)

Se aplica a

Consulte también