SqlException-Klasse

Artikel
08/20/2007

Die Ausnahme, die ausgelöst wird, wenn SQL Server eine Warnung oder einen Fehler zurückgibt. Diese Klasse kann nicht geerbt werden.

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
<SerializableAttribute> _
Public NotInheritable Class SqlException
    Inherits DbException
'Usage
Dim instance As SqlException

[SerializableAttribute] 
public sealed class SqlException : DbException

[SerializableAttribute] 
public ref class SqlException sealed : public DbException

/** @attribute SerializableAttribute() */ 
public final class SqlException extends DbException

SerializableAttribute 
public final class SqlException extends DbException

Hinweise

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

Meldungen mit einem Schweregrad von bis zu 10 sind Informationsmeldungen und bezeichnen Probleme durch vom Benutzer fehlerhaft eingegebene Informationen. Schweregrade zwischen 11 und 16 werden durch Benutzer generiert und können durch den Benutzer korrigiert werden. Schweregrade zwischen 17 und 25 kennzeichnen Software- oder Hardwarefehler. Wenn ein Fehler mit einem Schweregrad von 17, 18 oder 19 auftritt, können Sie mit der Arbeit fortfahren, obwohl Sie eine bestimmte Anweisung möglicherweise nicht ausführen können.

Die SqlConnection bleibt bei einem Schweregrad bis 19 offen. SqlConnection wird in der Regel ab dem Schweregrad 20 geschlossen. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren. In beiden Fällen wird von der den Befehl ausführenden Methode eine SqlException ausgelöst.

Weitere Informationen über die von SQL Server gesendeten Warn- und Informationsmeldungen finden Sie in der SQL Server-Onlinedokumentation im Abschnitt zur Problembehandlung. Die SqlException-Klasse wird dem SQL Server-Schweregrad zugeordnet.

Beispiel

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

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

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

Vererbungshierarchie

System.Object
   System.Exception
     System.SystemException
       System.Runtime.InteropServices.ExternalException
         System.Data.Common.DbException
          System.Data.SqlClient.SqlException

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlException-Member
System.Data.SqlClient-Namespace
SqlError-Klasse
SqlErrorCollection-Klasse

Freigeben über