SqlError 类

定义

public ref class SqlError sealed

[System.Serializable]
public sealed class SqlError

[<System.Serializable>]
type SqlError = class

Public NotInheritable Class SqlError

继承

Object

SqlError

属性

SerializableAttribute

示例

以下示例显示 SqlError 集合中的每个内容 SqlErrorCollection 。

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

注解

发生错误时，.NET Framework Data Provider为SQL Server创建此类。 由类创建SqlException和管理SqlErrorCollection的实例SqlError。

严重级别为 10 或更低级别的消息是信息性的，并指示用户输入的信息错误导致的问题。 从 11 到 16 的严重性级别由用户生成，可由用户更正。 从 17 到 25 的严重性级别表示软件或硬件错误。 发生级别 17、18 或 19 错误时，可以继续工作，尽管可能无法执行特定语句。

当严重级别为 19 或更少时，仍 SqlConnection 保持打开状态。 当严重级别为 20 或更大时，服务器通常会关闭 。SqlConnection 但是，用户可以重新打开连接并继续。 在这两种情况下，执行命令的方法将生成 a SqlException 。

有关SQL Server生成的错误的详细信息，请参阅 数据库引擎 Errors。 有关严重性级别的详细信息，请参阅 数据库引擎 错误严重性。

另请参阅

• SqlErrorCollection
• SqlException
• ADO.NET 概述