SqlException.Class 屬性

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

取得從 .NET Framework Data Provider for 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 的值，表示錯誤的嚴重性層級。

範例

下列範例會顯示集合內的每一 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 或低於 19 時，SqlConnection 仍保持開啟。 當嚴重性層級為 20 或更新時，伺服器通常會關閉 SqlConnection。 但是，使用者可以再次開啟連線，然後繼續進行。 在這兩個情況中，SqlException 皆由執行該命令的方法所產生。

如需 SQL Server 所傳送之警告和參考訊息的相關信息，請參閱 SQL Server 檔的疑難解答一節。

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

另請參閱

• Number
• Source
• State
• Server
• Procedure
• LineNumber
• ADO.NET 概觀 \(部分機器翻譯\)