SqlError Osztály

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Összegyűjti az SQL Server által visszaadott figyelmeztetéssel vagy hibával kapcsolatos információkat.

public ref class SqlError sealed

[System.Serializable]
public sealed class SqlError

[<System.Serializable>]
type SqlError = class

Public NotInheritable Class SqlError

Öröklődés

Object

SqlError

Attribútumok

SerializableAttribute

Példák

Az alábbi példa mindegyik SqlError a gyűjteményen SqlErrorCollection belül jelenik meg.

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

Megjegyzések

Ezt az osztályt a .NET-keretrendszer Data Provider hozza létre SQL Server hiba esetén. A példányt SqlError az osztály hozza létre SqlErrorCollection és felügyeliSqlException.

A 10 vagy annál kisebb súlyosságú üzenetek tájékoztató jellegűek, és a felhasználó által megadott információk hibái által okozott problémákat jelzik. A 11 és 16 közötti súlyossági szinteket a felhasználó hozza létre, és a felhasználó módosíthatja. A 17 és 25 közötti súlyossági szintek szoftver- vagy hardverhibákat jeleznek. 17-es, 18-os vagy 19-es szintű hiba esetén folytathatja a munkát, bár előfordulhat, hogy nem tud végrehajtani egy adott utasítást.

A SqlConnection súlyossági szint 19-es vagy annál kisebb érték esetén is nyitva marad. Ha a súlyossági szint 20 vagy nagyobb, a kiszolgáló általában bezárja a SqlConnection. A felhasználó azonban újra megnyithatja a kapcsolatot, és folytathatja azt. A parancsot végrehajtó metódus mindkét esetben létrehoz egy SqlException parancsot.

A SQL Server által generált hibákról további információt a Database Engine Hibák című témakörben talál. A súlyossági szintekről további információt a Database Engine Hiba súlyossága című témakörben talál.

Tulajdonságok

Name	Description
Class	Lekéri a SQL Server visszaadott hiba súlyossági szintjét.
LineNumber	Lekéri a sorszámot a Transact-SQL parancskötegben vagy a hibát tartalmazó tárolt eljárásban.
Message	Lekéri a hibát leíró szöveget.
Number	Lekéri a hiba típusát azonosító számot.
Procedure	Lekéri a hibát létrehozó tárolt eljárás vagy távoli eljáráshívás (RPC) nevét.
Server	Lekéri annak a SQL Server-példánynak a nevét, amely a hibát generálta.
Source	Lekéri a hibát létrehozó szolgáltató nevét.
State	Lekéri a hiba egyedi állapotkódját.

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Lekéri a hibaüzenet teljes szövegét.

Lásd még

• SqlErrorCollection
• SqlException
• ADO.NET áttekintése