SqlException.Class 屬性

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

取得 .NET Framework 資料提供者 SQL Server 回傳錯誤的嚴重程度等級。

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的數值表示錯誤的嚴重程度。

範例

以下範例顯示每個集合中的SqlErrorCollection每個角色SqlError。

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。 不過，使用者可以重新開啟連線並繼續使用。 在這兩種情況下，a SqlException 都是由執行指令的方法產生。

關於 SQL Server 發送的警告與資訊訊息，請參閱 SQL Server 文件中的故障排除章節。

這是屬性Class中Errors第一個SqlError屬性的包裝器。

另請參閱

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