Clase SqlCeException

Artículo
05/27/2011

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
	SqlCeException	Constructor que ayuda en la serialización.

Arriba

Propiedades

	Nombre	Descripción
	Data	(se hereda de Exception)
	ErrorCode	(se hereda de ExternalException)
	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.
	HelpLink	(se hereda de Exception)
	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.
	InnerException	(se hereda de Exception)
	Message	Obtiene el texto que describe la primera instancia de SqlCeError en SqlCeErrorCollection de esta excepción. (Invalida Exception.Message.)
	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.
	Source	Obtiene el nombre del proveedor OLE DB que ha generado el error. (Invalida Exception.Source.)
	StackTrace	(se hereda de Exception)
	TargetSite	(se hereda de Exception)

Arriba

Métodos

	Nombre	Descripción
	Equals	(se hereda de Object)
	Finalize	(se hereda de Object)
	GetBaseException	(se hereda de Exception)
	GetHashCode	(se hereda de Object)
	GetObjectData	Importante para la seguridad. Rellena un cursor SerializationInfo con los datos necesarios para serializar el objeto. (Invalida Exception.GetObjectData(SerializationInfo, StreamingContext).)
	GetType	(se hereda de Exception)
	MemberwiseClone	(se hereda de Object)
	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.