OleDbException Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Excepción que se produce cuando el proveedor subyacente devuelve una advertencia o un error para un origen de datos de OLE DB. Esta clase no puede heredarse.
public ref class OleDbException sealed : System::Data::Common::DbExceptionpublic ref class OleDbException sealed : System::Runtime::InteropServices::ExternalExceptionpublic 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.DbExceptiontype OleDbException = class
inherit DbException[<System.Serializable>]
type OleDbException = class
inherit ExternalException[<System.Serializable>]
type OleDbException = class
inherit DbExceptionPublic NotInheritable Class OleDbException
Inherits DbExceptionPublic NotInheritable Class OleDbException
Inherits ExternalException- Herencia
- Herencia
- Atributos
Ejemplos
En el ejemplo siguiente se genera una OleDbException excepción debido a un origen de datos que falta y, a continuación, se muestra la excepción.
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. (Los errores del lado cliente se producen como excepciones estándar de Common Language Runtime). OleDbException siempre contiene al menos una instancia de OleDbError.
Si la gravedad del error es demasiado grande, el servidor puede cerrar OleDbConnection. Sin embargo, el usuario puede volver a abrir la conexión y continuar.
Para obtener información general sobre el control de excepciones para un proveedor de datos de .NET Framework, vea SqlException.
Propiedades
| BatchCommand |
Si se produjo al DbException ejecutar un DbBatchobjeto , hace referencia al elemento específico DbBatchCommand que desencadenó la excepción. (Heredado de DbException) |
| 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 elemento específico DbBatchCommand que desencadenó la excepción. (Heredado de DbException) |
| ErrorCode |
Obtiene el HRESULT del 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. |
| 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 el texto que describe el error. |
| Message |
Obtiene un mensaje que describe la excepción actual. (Heredado de Exception) |
| Source |
Obtiene el nombre del proveedor OLE DB que ha generado el error. |
| 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 |
| 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) |
Obsoletos.
Este miembro invalida GetObjectData(SerializationInfo, StreamingContext). |
| 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 |
Obsoletos.
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) |
