SqlException.Class-Eigenschaft

Ruft den Schweregrad des vom .NET Framework-Datenprovider für SQL Server zurückgegebenen Fehlers ab.

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

Syntax

'Declaration
Public ReadOnly Property Class As Byte
'Usage
Dim instance As SqlException
Dim value As Byte

value = instance.Class

public byte Class { get; }

public:
property unsigned char Class {
    unsigned char get ();
}

/** @property */
public byte get_Class ()

public function get Class () : byte

Eigenschaftenwert

Ein Wert zwischen 1 und 25, der den Schweregrad des Fehlers angibt.

Hinweise

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-Dokumentation im Abschnitt zur Problembehandlung.

Dies ist ein Wrapper für die Class-Eigenschaft des ersten SqlError in der Errors-Eigenschaft.

Beispiel

Im folgenden Beispiel wird jeder SqlError in der SqlErrorCollection-Auflistung 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());
        }
    }
}

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-Klasse
SqlException-Member
System.Data.SqlClient-Namespace
Number
Source
State
Server
Procedure
LineNumber