Compartir a través de


Clase SqlCeException

Excepción que se produce cuando el proveedor subyacente devuelve una advertencia o un error de un origen de datos SQL Server Compact. No se puede heredar esta clase.

Jerarquía de herencia

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        System.Data.Common.DbException
          System.Data.SqlServerCe.SqlCeException
            System.Data.SqlServerCe.SqlCeInvalidDatabaseFormatException
            System.Data.SqlServerCe.SqlCeLockTimeoutException
            System.Data.SqlServerCe.SqlCeTransactionInProgressException

Espacio de nombres:  System.Data.SqlServerCe
Ensamblado:  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Sintaxis

'Declaración
<SerializableAttribute> _
Public Class SqlCeException _
    Inherits DbException
'Uso
Dim instance As SqlCeException
[SerializableAttribute]
public class SqlCeException : DbException
[SerializableAttribute]
public ref class SqlCeException : public DbException
[<SerializableAttribute>]
type SqlCeException =  
    class
        inherit DbException
    end
public class SqlCeException extends DbException

El tipo SqlCeException expone los siguientes miembros.

Constructores

  Nombre Descripción
Método protegido SqlCeException Constructor que ayuda en la serialización.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública Data (se hereda de Exception)
Propiedad pública ErrorCode (se hereda de ExternalException)
Propiedad pública Errors Obtiene una colección de uno o varios objetos SqlCeError que contienen información detallada sobre las excepciones que genera el proveedor de datos de .NET Compact Framework para SQL Server Compact.
Propiedad pública HelpLink (se hereda de Exception)
Propiedad pública HResult Obtiene el valor HRESULT de la excepción. Este valor es el mismo que el valor de HResult de la primera instancia de SqlCeError en SqlCeErrorCollection de la excepción.
Propiedad pública InnerException (se hereda de Exception)
Propiedad pública Message Obtiene el texto que describe la primera instancia de SqlCeError en SqlCeErrorCollection de esta excepción. (Invalida Exception.Message.)
Propiedad pública NativeError Obtiene el número de error nativo del primer SqlCeError de SqlCeErrorCollection. Para obtener más información acerca del error, vea el tema sobre errores de SQL Server Compact en la sección de solución de problemas de los Libros en pantalla de SQL Server Compact.
Propiedad pública Source Obtiene el nombre del proveedor OLE DB que ha generado el error. (Invalida Exception.Source.)
Propiedad pública StackTrace (se hereda de Exception)
Propiedad pública TargetSite (se hereda de Exception)

Arriba

Métodos

  Nombre Descripción
Método público Equals (se hereda de Object)
Método protegido Finalize (se hereda de Object)
Método público GetBaseException (se hereda de Exception)
Método público GetHashCode (se hereda de Object)
Método público GetObjectData Importante para la seguridad. Rellena un cursor SerializationInfo con los datos necesarios para serializar el objeto. (Invalida Exception.GetObjectData(SerializationInfo, StreamingContext).)
Método público GetType (se hereda de Exception)
Método protegido MemberwiseClone (se hereda de Object)
Método público ToString (se hereda de Exception)

Arriba

Comentarios

Esta clase se crea siempre que el proveedor de datos de .NET Compact Framework para SQL Server Compact encuentra un error generado en el motor SQL Server Compact. Otros errores se producen como excepciones estándar de Common Language Runtime. SqlCeException siempre contiene al menos una instancia de SqlCeError.

Ejemplos

En el ejemplo siguiente se genera una SqlCeException porque falta un origen de datos y, a continuación, se muestra la excepción.

Dim conn As New SqlCeConnection("Data Source=nonExistingSource.sdf;")

Try
    conn.Open()
Catch e As SqlCeException
    ' Use SqlCeException properties if you need specific
    ' application logic depending on the error condition
    '
    If 25046 = e.NativeError Then 'SSCE_M_FILENOTFOUND
        ' Error specific logic goes here...
        '
    End If

    MessageBox.Show(e.Message)
End Try
SqlCeConnection conn = new SqlCeConnection("Data Source=nonExistingSource.sdf;");

try
{
    conn.Open();
}
catch (SqlCeException e)
{
    // Use SqlCeException properties if you need specific
    // application logic depending on the error condition
    //
    if (25046 == e.NativeError /*SSCE_M_FILENOTFOUND*/)
    {
        // Error specific logic goes here...
        //
    }

    MessageBox.Show(e.Message);
}

Seguridad para subprocesos

Todos los miembros estáticos públicos (Shared in Microsoft Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

Espacio de nombres System.Data.SqlServerCe

SqlCeError

SqlCeErrorCollection