Classe SqlCeError

  • Article

Recueille les informations relatives à un avertissement ou une erreur retournés par la source de données. Cette classe ne peut pas être héritée.

Hiérarchie d'héritage

System.Object
  System.Data.SqlServerCe.SqlCeError

Espace de noms :  System.Data.SqlServerCe
Assembly :  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Syntaxe

'Déclaration
<SerializableAttribute> _
Public NotInheritable Class SqlCeError
'Utilisation
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

Le type SqlCeError expose les membres suivants.

Propriétés

  Nom Description
Propriété publique ErrorParameters Obtient les trois derniers paramètres d'erreur. Les paramètres d'erreur sont utilisés par SQL Server Compact pour fournir des détails supplémentaires concernant une erreur.
Propriété publique HResult Retourne une valeur HRESULT qui identifie le type d'erreur.
Propriété publique Message Obtient le texte décrivant l'erreur.
Propriété publique NativeError Obtient le numéro d'erreur native de SqlCeError. Pour plus d'informations sur ces erreurs, consultez la rubrique « SQL Server Compact Errors » dans la section de dépannage de la documentation en ligne de SQL Server Compact.
Propriété publique NumericErrorParameters Obtient les trois premiers paramètres d'erreur. Les paramètres d'erreur sont utilisés par SQL Server Compact pour fournir des détails supplémentaires concernant une erreur.
Propriété publique Source Obtient le nom du fournisseur qui a généré l'erreur.

Haut de la page

Méthodes

  Nom Description
Méthode publique Equals (hérité de Object)
Méthode protégée Finalize (hérité de Object)
Méthode publique GetHashCode (hérité de Object)
Méthode publique GetType (hérité de Object)
Méthode protégée MemberwiseClone (hérité de Object)
Méthode publique ToString Obtient le texte complet du message d'erreur. (remplace Object.ToString().)

Haut de la page

Notes

Une instance de SqlCeError est créée par le fournisseur managé System.Data.SqlServerCe lorsqu'une erreur se produit. SqlCeErrorCollection contient une ou plusieurs instances de SqlCeError.

Exemples

L'exemple suivant illustre une utilisation type 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);
    }
}

Sécurité des threads

Tout membre statique public (Shared en Microsoft Visual Basic) de ce type est thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Voir aussi

Référence

Espace de noms System.Data.SqlServerCe

SqlCeErrorCollection

SqlCeException