Classe SqlCeError

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.

System.Object
  System.Data.SqlServerCe.SqlCeError

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

'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.

	Nom	Description
	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.
	HResult	Retourne une valeur HRESULT qui identifie le type d'erreur.
	Message	Obtient le texte décrivant l'erreur.
	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.
	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.
	Source	Obtient le nom du fournisseur qui a généré l'erreur.

Haut de la page

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

Haut de la page

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.

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);
    }
}

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.

Espace de noms System.Data.SqlServerCe

SqlCeErrorCollection

SqlCeException