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
	SqlCeException	Construtor que auxilia na serialização.

Início

Propriedades

	Nome	Descrição
	Data	(herança de Exception)
	ErrorCode	(herança de ExternalException)
	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.
	HelpLink	(herança de Exception)
	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.
	InnerException	(herança de Exception)
	Message	Obtém o texto que descreve a primeira instância de SqlCeError na SqlCeErrorCollection para esta exceção. (Substitui Exception.Message.)
	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.
	Source	Obtém o nome do provedor OLE DB que gerou o erro. (Substitui Exception.Source.)
	StackTrace	(herança de Exception)
	TargetSite	(herança de Exception)

Início

Métodos

	Nome	Descrição
	Equals	(herança de Object)
	Finalize	(herança de Object)
	GetBaseException	(herança de Exception)
	GetHashCode	(herança de Object)
	GetObjectData	Segurança crítica. Popula um SerializationInfo com os dados necessários para serializar o objeto. (Substitui Exception.GetObjectData(SerializationInfo, StreamingContext).)
	GetType	(herança de Exception)
	MemberwiseClone	(herança de Object)
	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