SqlError-Klasse

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

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

Syntax

'Declaration
<SerializableAttribute> _
Public NotInheritable Class SqlError
'Usage
Dim instance As SqlError

[SerializableAttribute] 
public sealed class SqlError

[SerializableAttribute] 
public ref class SqlError sealed

/** @attribute SerializableAttribute() */ 
public final class SqlError

SerializableAttribute 
public final class SqlError

Hinweise

Diese Klasse wird vom .NET Framework-Datenprovider für SQL Server erstellt, wenn ein Fehler auftritt. Es wird eine Instanz der SqlError-Klasse erstellt und von der SqlErrorCollection-Klasse verwaltet, die durch die SqlException-Klasse erstellt wird.

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 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

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

Vererbungshierarchie

System.Object
  System.Data.SqlClient.SqlError

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

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