Classe SqlCeError

Raccoglie informazioni importanti relative a un avviso o a un errore restituito dall'origine dati. Questa classe non può essere ereditata.

Gerarchia di ereditarietà

System.Object
  System.Data.SqlServerCe.SqlCeError

Spazio dei nomi  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Sintassi

'Dichiarazione
<SerializableAttribute> _
Public NotInheritable Class SqlCeError
'Utilizzo
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

Nel tipo SqlCeError sono esposti i membri seguenti.

Proprietà

	Nome	Descrizione
	ErrorParameters	Ottiene gli ultimi tre parametri di errore. I parametri di errore vengono utilizzati da SQL Server Compact per fornire dettagli aggiuntivi su un errore.
	HResult	Restituisce un valore HRESULT che identifica il tipo di errore.
	Message	Ottiene il testo che descrive l'errore.
	NativeError	Ottiene il numero di errore nativo dell'oggetto SqlCeError. Per ulteriori informazioni su questi errori, vedere l'argomento relativo agli errori in SQL Server Compact nella sezione sulla risoluzione dei problemi nella documentazione online di SQL Server Compact.
	NumericErrorParameters	Ottiene i primi tre parametri di errore. I parametri di errore vengono utilizzati da SQL Server Compact per fornire dettagli aggiuntivi su un errore.
	Source	Ottiene il nome del provider che ha generato l’errore.

In alto

Metodi

	Nome	Descrizione
	Equals	(ereditato da Object)
	Finalize	(ereditato da Object)
	GetHashCode	(ereditato da Object)
	GetType	(ereditato da Object)
	MemberwiseClone	(ereditato da Object)
	ToString	Ottiene il testo completo del messaggio di errore. Esegue l'override di Object.ToString().

In alto

Osservazioni

Quando si verifica un errore, viene creata un'istanza di SqlCeError dal provider gestito System.Data.SqlServerCe. L'oggetto SqlCeErrorCollection contiene una o più istanze di SqlCeError.

Esempi

Nell'esempio che segue è illustrato un utilizzo tipico della classe 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);
    }
}

Protezione dei thread

I membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi System.Data.SqlServerCe

SqlCeErrorCollection

SqlCeException