SqlException.Class 属性

定义

命名空间:

System.Data.SqlClient

程序集:

System.Data.dll

获取从 SQL Server .NET Framework 数据提供程序返回的错误的严重级别。

public:
 property System::Byte Class { System::Byte get(); };

public byte Class { get; }

member this.Class : byte

Public ReadOnly Property Class As Byte

属性值

Byte

一个 1 至 25 的值，它指示错误的严重级别。

示例

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

using System;
using System.Data;
using System.Data.SqlClient;
using System.Text;

class Program
{
    static void Main()
    {
        string s = GetConnectionString();
        ShowSqlException(s);
        Console.ReadLine();
    }

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

        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            SqlCommand command = new SqlCommand(queryString, connection);
            try
            {
                command.Connection.Open();
                command.ExecuteNonQuery();
            }
            catch (SqlException ex)
            {
                for (int i = 0; i < ex.Errors.Count; i++)
                {
                    errorMessages.Append("Index #" + i + "\n" +
                        "Message: " + ex.Errors[i].Message + "\n" +
                        "Error Number: " + ex.Errors[i].Number + "\n" +
                        "LineNumber: " + ex.Errors[i].LineNumber + "\n" +
                        "Source: " + ex.Errors[i].Source + "\n" +
                        "Procedure: " + ex.Errors[i].Procedure + "\n");
                }
                Console.WriteLine(errorMessages.ToString());
            }
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI";
    }
}

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

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

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

        Catch ex As SqlException
            Dim i As Integer
            For i = 0 To ex.Errors.Count - 1
                errorMessages.Append("Index #" & i.ToString() & ControlChars.NewLine _
                    & "Message: " & ex.Errors(i).Message & ControlChars.NewLine _
                    & "Error Number: " & ex.Errors(i).Number & ControlChars.NewLine _
                    & "LineNumber: " & ex.Errors(i).LineNumber & ControlChars.NewLine _
                    & "Source: " & ex.Errors(i).Source & ControlChars.NewLine _
                    & "Procedure: " & ex.Errors(i).Procedure & ControlChars.NewLine)
            Next i
            Console.WriteLine(errorMessages.ToString())
        End Try
    End Using
End Sub

注解

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

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

有关SQL Server发送的警告和信息性消息的信息，请参阅SQL Server文档的故障排除部分。

这是 属性中 Class 第一个 SqlError 的 属性的 Errors 包装器。

另请参阅

• Number
• Source
• State
• Server
• Procedure
• LineNumber
• ADO.NET 概述