Classe SqlCeException

Exception levée lorsque le fournisseur sous-jacent retourne un avertissement ou une erreur à partir d'une source de données SQL Server Compact. Cette classe ne peut pas être héritée.

Hiérarchie d'héritage

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        System.Data.Common.DbException
          System.Data.SqlServerCe.SqlCeException
            System.Data.SqlServerCe.SqlCeInvalidDatabaseFormatException
            System.Data.SqlServerCe.SqlCeLockTimeoutException
            System.Data.SqlServerCe.SqlCeTransactionInProgressException

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

Syntaxe

'Déclaration
<SerializableAttribute> _
Public Class SqlCeException _
    Inherits DbException
'Utilisation
Dim instance As SqlCeException

[SerializableAttribute]
public class SqlCeException : DbException

[SerializableAttribute]
public ref class SqlCeException : public DbException

[<SerializableAttribute>]
type SqlCeException =  
    class
        inherit DbException
    end

public class SqlCeException extends DbException

Le type SqlCeException expose les membres suivants.

Constructeurs

	Nom	Description
	SqlCeException	Constructeur qui facilite la sérialisation.

Haut de la page

Propriétés

	Nom	Description
	Data	(hérité de Exception)
	ErrorCode	(hérité de ExternalException)
	Errors	Obtient une collection d'un ou de plusieurs objets SqlCeError qui contiennent des informations détaillées sur les exceptions générées par le fournisseur de données .NET Compact Framework pour SQL Server Compact.
	HelpLink	(hérité de Exception)
	HResult	Obtient la valeur HRESULT de l'exception. Cette valeur est la même que la valeur de la propriété HResult pour la première instance de SqlCeError dans SqlCeErrorCollection pour l'exception.
	InnerException	(hérité de Exception)
	Message	Obtient le texte décrivant la première instance de SqlCeError dans SqlCeErrorCollection pour cette exception. (remplace Exception.Message.)
	NativeError	Obtient le numéro d'erreur native du premier SqlCeError dans SqlCeErrorCollection. Pour plus d'informations sur l'erreur, consultez la rubrique « Erreurs SQL Server Compact » dans la section Dépannage de la documentation en ligne de SQL Server Compact.
	Source	Obtient le nom du fournisseur OLE DB qui a généré l'erreur. (remplace Exception.Source.)
	StackTrace	(hérité de Exception)
	TargetSite	(hérité de Exception)

Haut de la page

Méthodes

	Nom	Description
	Equals	(hérité de Object)
	Finalize	(hérité de Object)
	GetBaseException	(hérité de Exception)
	GetHashCode	(hérité de Object)
	GetObjectData	Informations critiques de sécurité. Remplit SerializationInfo avec les données requises pour sérialiser l'objet. (remplace Exception.GetObjectData(SerializationInfo, StreamingContext).)
	GetType	(hérité de Exception)
	MemberwiseClone	(hérité de Object)
	ToString	(hérité de Exception)

Haut de la page

Notes

Cette classe est créée chaque fois que le fournisseur de données .NET Compact Framework pour SQL Server Compact rencontre une erreur générée dans le moteur SQL Server Compact. (Les autres erreurs sont levées en tant qu'exceptions standard du Common Language Runtime.) SqlCeException comporte toujours au moins une instance de SqlCeError.

Exemples

L'exemple suivant génère un SqlCeException résultant de l'absence d'une source de données, puis affiche l'exception.

Dim conn As New SqlCeConnection("Data Source=nonExistingSource.sdf;")

Try
    conn.Open()
Catch e As SqlCeException
    ' Use SqlCeException properties if you need specific
    ' application logic depending on the error condition
    '
    If 25046 = e.NativeError Then 'SSCE_M_FILENOTFOUND
        ' Error specific logic goes here...
        '
    End If

    MessageBox.Show(e.Message)
End Try

SqlCeConnection conn = new SqlCeConnection("Data Source=nonExistingSource.sdf;");

try
{
    conn.Open();
}
catch (SqlCeException e)
{
    // Use SqlCeException properties if you need specific
    // application logic depending on the error condition
    //
    if (25046 == e.NativeError /*SSCE_M_FILENOTFOUND*/)
    {
        // Error specific logic goes here...
        //
    }

    MessageBox.Show(e.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

SqlCeError

SqlCeErrorCollection