Partilhar via


Classe SqlCeException

A exceção lançada quando o provedor subjacente retorna um aviso ou um erro de uma fonte de dados do SQL Server Compact. Esta classe não pode ser herdada.

Hierarquia de herança

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

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
<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

O tipo SqlCeException expõe os membros a seguir.

Construtores

  Nome Descrição
Método protegido SqlCeException Construtor que auxilia na serialização.

Início

Propriedades

  Nome Descrição
Propriedade pública Data (herança de Exception)
Propriedade pública ErrorCode (herança de ExternalException)
Propriedade pública Errors Obtém uma coleção de um ou mais objetos SqlCeError que contêm informações detalhadas sobre as exceções geradas pelo Provedor de Dados do .NET Compact Framework para SQL Server Compact.
Propriedade pública HelpLink (herança de Exception)
Propriedade pública HResult Obtém o valor HRESULT da exceção. Esse valor é igual ao valor de HResult para a primeira instância de SqlCeError na SqlCeErrorCollection para a exceção.
Propriedade pública InnerException (herança de Exception)
Propriedade pública Message Obtém o texto que descreve a primeira instância de SqlCeError na SqlCeErrorCollection para esta exceção. (Substitui Exception.Message.)
Propriedade pública NativeError Obtém o número do erro nativo do primeiro SqlCeError da SqlCeErrorCollection. Para obter mais informações sobre o erro, consulte o tópico "Erros do SQL Server Compact" na seção de Solução de Problemas dos Manuais Online do SQL Server Compact.
Propriedade pública Source Obtém o nome do provedor OLE DB que gerou o erro. (Substitui Exception.Source.)
Propriedade pública StackTrace (herança de Exception)
Propriedade pública TargetSite (herança de Exception)

Início

Métodos

  Nome Descrição
Método público Equals (herança de Object)
Método protegido Finalize (herança de Object)
Método público GetBaseException (herança de Exception)
Método público GetHashCode (herança de Object)
Método público GetObjectData Segurança crítica. Popula um SerializationInfo com os dados necessários para serializar o objeto. (Substitui Exception.GetObjectData(SerializationInfo, StreamingContext).)
Método público GetType (herança de Exception)
Método protegido MemberwiseClone (herança de Object)
Método público ToString (herança de Exception)

Início

Comentários

Esta classe é criada sempre que o Provedor de Dados do .NET Compact Framework para SQL Server Compact encontra um erro gerado dentro do mecanismo do SQL Server Compact. (Outros erros são lançados como exceções de tempo de execução de linguagem comum padrão.) SqlCeException sempre contém pelo menos uma instância de SqlCeError.

Exemplos

O exemplo a seguir gera uma SqlCeException devido a uma fonte de dados ausente e, em seguida, exibe a exceção.

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);
}

Segurança de thread

Qualquer membro estático público (Shared no Microsoft Visual Basic) desse tipo é seguro para threads. Não há garantia de que qualquer membro de instância seja seguro para threads.

Consulte também

Referência

Namespace System.Data.SqlServerCe

SqlCeError

SqlCeErrorCollection