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.