SqlError.Class-Eigenschaft

Ruft den Schweregrad des von 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 SqlError
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. Der Standardwert ist 0 (null).

Hinweise

Meldungen mit einem Schweregrad von bis zu 10 sind Informationsmeldungen und bezeichnen Probleme durch Fehler in Informationen, die durch Benutzer eingegeben wurden. 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-Klasse bleibt bei einem Schweregrad bis 19 offen. Wenn der Schweregrad 20 oder größer ist, schließt der Server normalerweise die SqlConnection-Klasse. 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.

Beispiel

Im folgenden Beispiel wird jede SqlError-Klasse in der SqlErrorCollection-Auflistung angezeigt.

Public Sub DisplaySqlErrors(ByVal exception As SqlException)
    Dim i As Integer

    For i = 0 To exception.Errors.Count - 1
        Console.WriteLine(("Index #" & i & ControlChars.NewLine & _
            "Source: " & exception.Errors(i).Source & ControlChars.NewLine & _
            "Number: " & exception.Errors(i).Number.ToString() & ControlChars.NewLine & _
            "State: " & exception.Errors(i).State.ToString() & ControlChars.NewLine & _
            "Class: " & exception.Errors(i).Class.ToString() & ControlChars.NewLine & _
            "Server: " & exception.Errors(i).Server & ControlChars.NewLine & _
            "Message: " & exception.Errors(i).Message & ControlChars.NewLine & _
            "Procedure: " & exception.Errors(i).Procedure & ControlChars.NewLine & _
            "LineNumber: " & exception.Errors(i).LineNumber.ToString()))
    Next i
    Console.ReadLine()
End Sub

public void DisplaySqlErrors(SqlException exception)
{
    for (int i = 0; i < exception.Errors.Count; i++)
    {
        Console.WriteLine("Index #" + i + "\n" +
            "Source: " + exception.Errors[i].Source + "\n" +
            "Number: " + exception.Errors[i].Number.ToString() + "\n" +
            "State: " + exception.Errors[i].State.ToString() + "\n" +
            "Class: " + exception.Errors[i].Class.ToString() + "\n" +
            "Server: " + exception.Errors[i].Server + "\n" +
            "Message: " + exception.Errors[i].Message + "\n" +
            "Procedure: " + exception.Errors[i].Procedure + "\n" +
            "LineNumber: " + exception.Errors[i].LineNumber.ToString());
    }
    Console.ReadLine();
}

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

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