SqlException Klasse

Definition

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

Vererbung

Object

Exception

DbException

SqlException

Vererbung

Object

Exception

SystemException

ExternalException

DbException

SqlException

Vererbung

Object

Exception

SystemException

SqlException

Attribute

SerializableAttribute

Beispiele

Im folgenden Beispiel wird eine SqlException generiert und dann die Ausnahme angezeigt.

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

Hinweise

Diese Klasse wird immer dann erstellt, wenn beim .NET Framework-Datenanbieter für SQL Server ein Fehler auftritt, der vom Server generiert wird. (Clientseitige Fehler werden als Standardausnahmen der Common Language Runtime ausgelöst.) SqlException enthält immer mindestens eine Instanz von SqlError.

Nachrichten mit einem Schweregrad von 10 oder weniger sind informationserregend und weisen auf Probleme hin, die durch Fehler in den Von einem Benutzer eingegebenen Informationen verursacht werden. Schweregrade von 11 bis 16 werden vom Benutzer generiert und können vom Benutzer korrigiert werden. Schweregrade von 17 bis 25 zeigen Software- oder Hardwarefehler an. Wenn ein Fehler der Ebene 17, 18 oder 19 auftritt, können Sie weiterarbeiten, obwohl Sie möglicherweise nicht in der Lage sind, eine bestimmte Anweisung auszuführen.

Die SqlConnection bleibt hergestellt, wenn der Schweregrad 19 oder darunter beträgt. Wenn der Schweregrad 20 oder höher ist, schließt der Server normalerweise .SqlConnection Die Benutzer können die Verbindung aber erneut öffnen und fortfahren. In beiden Fällen wird von der Methode, die den Befehl ausführt, eine SqlException generiert.

Informationen zu den von SQL Server gesendeten Warnungen und Informationsmeldungen finden Sie unter Ereignisse und Fehler der Datenbank-Engine. Die SqlException -Klasse wird dem SQL Server-Schweregrad zugeordnet.

Im Folgenden sind allgemeine Informationen zur Behandlung von Ausnahmen aufgeführt. Ihr Code sollte Ausnahmen abfangen, um zu verhindern, dass die Anwendung abstürzt und dem Benutzer eine relevante Fehlermeldung angezeigt wird. Sie können Datenbanktransaktionen verwenden, um sicherzustellen, dass die Daten konsistent sind, unabhängig davon, was in der Clientanwendung geschieht (einschließlich eines Absturzes). Features wie System.Transaction.TransactionScope oder die BeginTransaction-Methode (in System.Data.OleDb.OleDbConnection, System.Data.ODBC.ODBCConnection und System.Data.SqlClient.SqlConnection) stellen konsistente Daten sicher, unabhängig von Ausnahmen, die von einem Anbieter ausgelöst werden. Transaktionen können fehlschlagen. Daher können Sie Fehler abfangen und die Transaktion wiederholen.

Beachten Sie, dass ab .NET Framework 4.5 SqlException eine innere Win32Exceptionzurückgeben kann.

Die Ausnahmeklasse eines .NET Framework-Datenanbieters meldet anbieterspezifische Fehler. System.Data.Odbc verfügt beispielsweise über OdbcException, System.Data.OleDb über OleDbException und System.Data.SqlClient über SqlException. Um die beste Ebene der Fehlerdetails zu erhalten, fangen Sie diese Ausnahmen ab, und verwenden Sie die Member dieser Ausnahmeklassen, um Details zum Fehler abzurufen.

Zusätzlich zu den anbieterspezifischen Fehlern können .NET Framework-Datenanbietertypen .NET Framework-Ausnahmen auslösen, z. B. System.OutOfMemoryException und System.Threading.ThreadAbortException. Die Wiederherstellung von diesen Ausnahmen ist möglicherweise nicht möglich.

Eine fehlerhafte Eingabe kann dazu führen, dass ein .NET Framework-Datenanbietertyp eine Ausnahme wie System.ArgumentException oder System.IndexOutOfRangeException auslöst. Das Aufrufen einer Methode zur falschen Zeit kann System.InvalidOperationException auslösen.

Schreiben Sie also im Allgemeinen einen Ausnahmehandler, der alle anbieterspezifischen Ausnahmen sowie Ausnahmen aus der Common Language Runtime abfängt. Diese können wie folgt überschichtet werden:

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

Oder:

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

Es ist auch möglich, dass ein .NET Framework-Datenanbietermethodenaufruf in einem Threadpoolthread ohne Benutzercode im Stapel fehlschlägt. In diesem Fall und bei Verwendung asynchroner Methodenaufrufe müssen Sie das UnhandledException Ereignis registrieren, um diese Ausnahmen zu behandeln und Anwendungsabsturz zu vermeiden.

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• SqlError
• SqlErrorCollection
• Übersicht über ADO.NET