SqlException Classe

Définition

public ref class SqlException sealed : System::Data::Common::DbException

public ref class SqlException sealed : SystemException

public sealed class SqlException : System.Data.Common.DbException

[System.Serializable]
public sealed class SqlException : SystemException

[System.Serializable]
public sealed class SqlException : System.Data.Common.DbException

type SqlException = class
    inherit DbException

[<System.Serializable>]
type SqlException = class
    inherit SystemException

[<System.Serializable>]
type SqlException = class
    inherit DbException

Public NotInheritable Class SqlException
Inherits DbException

Public NotInheritable Class SqlException
Inherits SystemException

Héritage

Object

Exception

DbException

SqlException

Héritage

Object

Exception

SystemException

ExternalException

DbException

SqlException

Héritage

Object

Exception

SystemException

SqlException

Attributs

SerializableAttribute

Exemples

L’exemple suivant génère un SqlException , puis affiche l’exception .

public static void ShowSqlException(string connectionString)
{
    string queryString = "EXECUTE NonExistantStoredProcedure";
    StringBuilder errorMessages = new StringBuilder();

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        try
        {
            command.Connection.Open();
            command.ExecuteNonQuery();
        }
        catch (SqlException ex)
        {
            for (int i = 0; i < ex.Errors.Count; i++)
            {
                errorMessages.Append("Index #" + i + "\n" +
                    "Message: " + ex.Errors[i].Message + "\n" +
                    "LineNumber: " + ex.Errors[i].LineNumber + "\n" +
                    "Source: " + ex.Errors[i].Source + "\n" +
                    "Procedure: " + ex.Errors[i].Procedure + "\n");
            }
            Console.WriteLine(errorMessages.ToString());
        }
    }
}

Public Sub ShowSqlException(ByVal connectionString As String)
    Dim queryString As String = "EXECUTE NonExistantStoredProcedure"
    Dim errorMessages As New StringBuilder()

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)

        Try
            command.Connection.Open()
            command.ExecuteNonQuery()

        Catch ex As SqlException
            Dim i As Integer
            For i = 0 To ex.Errors.Count - 1
                errorMessages.Append("Index #" & i.ToString() & ControlChars.NewLine _
                    & "Message: " & ex.Errors(i).Message & ControlChars.NewLine _
                    & "LineNumber: " & ex.Errors(i).LineNumber & ControlChars.NewLine _
                    & "Source: " & ex.Errors(i).Source & ControlChars.NewLine _
                    & "Procedure: " & ex.Errors(i).Procedure & ControlChars.NewLine)
            Next i
            Console.WriteLine(errorMessages.ToString())
        End Try
    End Using
End Sub

Remarques

Cette classe est créée chaque fois que le fournisseur de données .NET Framework pour SQL Server rencontre une erreur générée à partir du serveur. (Les erreurs côté client sont levées en tant qu’exceptions du Common Language Runtime standard.) SqlException contient toujours au moins une instance de SqlError.

Les messages dont le niveau de gravité est inférieur ou égal à 10 sont informatifs et indiquent des problèmes causés par des erreurs dans les informations qu’un utilisateur a entrées. Les niveaux de gravité de 11 à 16 sont générés par l’utilisateur et peuvent être corrigés par l’utilisateur. Les niveaux de gravité compris entre 17 et 25 indiquent des erreurs logicielles ou matérielles. Lorsqu’une erreur de niveau 17, 18 ou 19 se produit, vous pouvez continuer à travailler, bien que vous ne puissiez peut-être pas exécuter une instruction particulière.

SqlConnection reste ouvert lorsque le niveau de gravité est inférieur ou égal à 19. Lorsque le niveau de gravité est supérieur ou égal à 20, le serveur ferme généralement le SqlConnection. L'utilisateur peut toutefois rouvrir la connexion et continuer. Dans les deux cas, SqlException est généré par la méthode qui exécute la commande.

Pour plus d’informations sur les messages d’avertissement et d’information envoyés par SQL Server, consultez Événements et erreurs du moteur de base de données. La SqlException classe est mappée à la gravité de SQL Server.

Voici des informations générales sur la gestion des exceptions. Votre code doit intercepter les exceptions pour empêcher l’application de se bloquer et pour permettre à l’utilisateur d’afficher un message d’erreur pertinent. Vous pouvez utiliser des transactions de base de données pour vous assurer que les données sont cohérentes, quel que soit ce qui se passe dans l’application cliente (y compris un incident). Les fonctionnalités telles que System.Transaction.TransactionScope ou la méthode BeginTransaction (dans System.Data.OleDb.OleDbConnection, System.Data.ODBC.ODBCConnection et System.Data.SqlClient.SqlConnection) garantissent la cohérence des données, quelles que soient les exceptions levées par un fournisseur. Les transactions peuvent échouer. Par conséquent, interceptez les échecs et réessayez la transaction.

Notez qu’à partir de .NET Framework 4.5, SqlException peut retourner un interne Win32Exception.

La classe exception d’un fournisseur de données .NET Framework signale des erreurs spécifiques au fournisseur. Par exemple, System.Data.Odbc a OdbcException, System.Data.OleDb a OleDbException et System.Data.SqlClient a SqlException. Pour obtenir le meilleur niveau de détail d’erreur, interceptez ces exceptions et utilisez les membres de ces classes d’exception pour obtenir des détails sur l’erreur.

En plus des erreurs spécifiques au fournisseur, les types de fournisseurs de données .NET Framework peuvent déclencher des exceptions .NET Framework telles que System.OutOfMemoryException et System.Threading.ThreadAbortException. La récupération à partir de ces exceptions peut ne pas être possible.

Une entrée incorrecte peut entraîner le déclenchement d’une exception par exemple System.ArgumentException ou System.IndexOutOfRangeException pour un type de fournisseur de données .NET Framework. L’appel d’une méthode au mauvais moment peut déclencher System.InvalidOperationException.

Ainsi, en général, écrivez un gestionnaire d’exceptions qui intercepte les exceptions spécifiques au fournisseur, ainsi que les exceptions du Common Language Runtime. Celles-ci peuvent être superposées comme suit :

try {  
   // code here  
}  
catch (SqlException odbcEx) {  
   // Handle more specific SqlException exception here.  
}  
catch (Exception ex) {  
   // Handle generic ones here.  
}  

Ou :

try {  
   // code here  
}  
catch (Exception ex) {  
   if (ex is SqlException) {  
      // Handle more specific SqlException exception here.  
   }  
   else {  
      // Handle generic ones here.  
   }  
}  

Il est également possible qu’un appel de méthode de fournisseur de données .NET Framework échoue sur un thread de pool de threads sans code utilisateur sur la pile. Dans ce cas, et lorsque vous utilisez des appels de méthode asynchrones, vous devez inscrire l’événement UnhandledException pour gérer ces exceptions et éviter le blocage de l’application.

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• SqlError
• SqlErrorCollection
• Vue d'ensemble d’ADO.NET