Compartilhar via


Classe SqlCeError

Coleta informações relevantes para um aviso ou erro retornado pela fonte de dados. Esta classe não pode ser herdada.

Hierarquia de herança

System.Object
  System.Data.SqlServerCe.SqlCeError

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

Sintaxe

'Declaração
<SerializableAttribute> _
Public NotInheritable Class SqlCeError
'Uso
Dim instance As SqlCeError
[SerializableAttribute]
public sealed class SqlCeError
[SerializableAttribute]
public ref class SqlCeError sealed
[<SealedAttribute>]
[<SerializableAttribute>]
type SqlCeError =  class end
public final class SqlCeError

O tipo SqlCeError expõe os membros a seguir.

Propriedades

  Nome Descrição
Propriedade pública ErrorParameters Obtém os últimos três parâmetros de erro. Os parâmetros de erro são usados pelo SQL Server Compact para fornecer detalhes adicionais sobre um erro.
Propriedade pública HResult Retorna um valor HRESULT que identifica o tipo de erro.
Propriedade pública Message Obtém o texto que descreve o erro.
Propriedade pública NativeError Obtém o número do erro nativo do SqlCeError. Para obter mais informações sobre esses erros, consulte "Erros do SQL Server Compact" na seção de Solução de Problemas dos Manuais Online do SQL Server Compact.
Propriedade pública NumericErrorParameters Obtém os primeiros três parâmetros de erro. Os parâmetros de erro são usados pelo SQL Server Compact para fornecer detalhes adicionais sobre um erro.
Propriedade pública Source Obtém o nome do provedor que gerou o erro.

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 GetHashCode (herança de Object)
Método público GetType (herança de Object)
Método protegido MemberwiseClone (herança de Object)
Método público ToString Obtém o texto completo da mensagem de erro. (Substitui Object.ToString().)

Início

Comentários

Uma instância do SqlCeError será criada pelo provedor gerenciado do System.Data.SqlServerCe quando ocorrer um erro. A SqlCeErrorCollection contém uma ou mais instâncias do SqlCeError.

Exemplos

O exemplo a seguir mostra um uso típico de SqlCeError.

Try
    Dim repl As New SqlCeReplication()

    ' Fill repl properites here
    ' ...
    ' SqlCeReplication may throw SqlCeException which contains a 
    ' collection of errors; SQL Mobile database engine always
    ' returns one error in the collection
    '
    repl.Synchronize()
Catch e As SqlCeException
    Dim err As SqlCeError
    For Each err In e.Errors
        ' Use SqlCeError properties if you need specific
        ' application logic depending on the error condition
        '
        If 28577 = [err].NativeError Then 'SSCE_M_SCHEMAHASCHANGED
            ' Error specific logic goes here...
            '
        End If

        ' Note: For native error numbers, refer to SQL Server Mobile Errors
        ' in the SQL Server Mobile Books Online
        '
        MessageBox.Show([err].Message)
    Next err
End Try
try
{
    SqlCeReplication repl = new SqlCeReplication();

    // Fill repl properites here
    // ...

    // SqlCeReplication may throw SqlCeException which contains a 
    // collection of errors; SQL Mobile database engine always
    // returns one error in the collection
    //
    repl.Synchronize();
}
catch (SqlCeException e)
{
    foreach (SqlCeError error in e.Errors)
    {
        // Use SqlCeError properties if you need specific
        // application logic depending on the error condition
        //
        if (28577 == error.NativeError /*SSCE_M_SCHEMAHASCHANGED*/)
        {
            // Error specific logic goes here...
            //
        }

        // Note: For native error numbers, refer to SQL Server Mobile Errors
        // in the SQL Server Mobile Books Online
        //
        MessageBox.Show(error.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

SqlCeErrorCollection

SqlCeException