SqlError Klasse

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Sammelt Informationen zu einer von SQL Server zurückgegebenen Warnung oder einem Fehler.

public ref class SqlError sealed

[System.Serializable]
public sealed class SqlError

[<System.Serializable>]
type SqlError = class

Public NotInheritable Class SqlError

Vererbung

Object

SqlError

Attribute

SerializableAttribute

Beispiele

Im folgenden Beispiel werden alle SqlError innerhalb der SqlErrorCollection Auflistung angezeigt.

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

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        try
        {
            command.Connection.Open();
            command.ExecuteNonQuery();
        }
        catch (SqlException ex)
        {
            DisplaySqlErrors(ex);
        }
    }
}

private static void DisplaySqlErrors(SqlException exception)
{
    for (int i = 0; i < exception.Errors.Count; i++)
    {
        Console.WriteLine("Index #" + i + "\n" +
            "Error: " + exception.Errors[i].ToString() + "\n");
    }
    Console.ReadLine();
}

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

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

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

        Catch ex As SqlException
            DisplaySqlErrors(ex)
        End Try
    End Using
End Sub

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

    For i = 0 To exception.Errors.Count - 1
        Console.WriteLine("Index #" & i & ControlChars.NewLine & _
            "Error: " & exception.Errors(i).ToString() & ControlChars.NewLine)
    Next i
    Console.ReadLine()
End Sub

Hinweise

Diese Klasse wird vom .NET Framework-Datenanbieter für SQL Server erstellt, wenn ein Fehler auftritt. Eine instance von SqlError wird von erstellt und verwaltet, die SqlErrorCollectionwiederum von der SqlException -Klasse erstellt wird.

Meldungen mit einem Schweregrad von 10 oder darunter dienen rein der Information. Sie zeigen Probleme an, die durch fehlerhafte Benutzereingaben verursacht wurden. 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 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 Methode, die den Befehl ausführt, eine SqlException generiert.

Weitere Informationen zu Fehlern, die von SQL Server generiert werden, finden Sie unter Fehler der Datenbank-Engine. Weitere Informationen zu Schweregraden finden Sie unter Schweregrade von Datenbank-Engine-Fehlern.

Eigenschaften

Class	Ruft den Schweregrad des von SQL Server zurückgegebenen Fehlers ab.
LineNumber	Ruft die Zeilennummer im Transact-SQL-Befehlsbatch oder in der gespeicherten Prozedur ab, in der der Fehler aufgetreten ist.
Message	Ruft den Text ab, der den Fehler beschreibt.
Number	Ruft eine Nummer ab, die den Fehlertyp angibt.
Procedure	Ruft den Namen der gespeicherten Prozedur oder des Remoteprozeduraufrufs (RPC) ab, der diesen Fehler generiert hat.
Server	Ruft den Namen der Instanz von SQL Server ab, die den Fehler generiert hat.
Source	Ruft den Namen des Providers ab, der den Fehler generiert hat.
State	Ruft den eindeutigen Zustandscode für den Fehler ab.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Ruft den vollständigen Text der Fehlermeldung ab.

Weitere Informationen

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