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
	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.
	HResult	Retorna um valor HRESULT que identifica o tipo de erro.
	Message	Obtém o texto que descreve o erro.
	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.
	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.
	Source	Obtém o nome do provedor que gerou o erro.

Início

Métodos

	Nome	Descrição
	Equals	(herança de Object)
	Finalize	(herança de Object)
	GetHashCode	(herança de Object)
	GetType	(herança de Object)
	MemberwiseClone	(herança de Object)
	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