SqlException.Class プロパティ

.NET Framework クラス ライブラリ リファレンス

SqlException.Class プロパティ

.NET Framework SQL Server 用データ プロバイダが返したエラーの重大度レベルを取得します。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Class As Byte

Visual Basic (使用法)

Dim instance As SqlException
Dim value As Byte

value = instance.Class

C#

public byte Class { get; }

C++

public:
property unsigned char Class {
    unsigned char get ();
}

J#

/** @property */
public byte get_Class ()

JScript

public function get Class
 () : byte

プロパティ値
エラーの重大度レベルを示す 1 ～ 25 の値。

解説

重大度レベルが 10 以下のメッセージは、情報メッセージです。これらは、ユーザーが入力した情報の誤りが原因の問題を示します。重大度レベルが 11 ～ 16 のメッセージは、ユーザーが生成し、修正できます。重要度レベルが 17 ～ 25 のメッセージは、ソフトウェアまたはハードウェアのエラーを示します。レベル 17、18、または 19 のエラーが発生した場合は、作業は続行できますが、一部のステートメントが実行できないことがあります。

重大度レベルが 19 以下のときは、SqlConnection は開いたままになります。重大度レベルが 20 以上のときは、通常、サーバーは SqlConnection を閉じます。ただし、ユーザーは接続を再び開いて、処理を継続できます。いずれの場合でも、SqlException は、コマンドを実行しているメソッドによって生成されます。

SQL Server が送信する警告メッセージと情報メッセージについては、『SQL Server ドキュメント』の「トラブルシューティング」を参照してください。

これは、Errors プロパティ内にある最初の SqlError の Class プロパティのラッパーです。

使用例

SqlErrorCollection コレクション内の各 SqlError を表示する例を次に示します。

Visual Basic

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 _
                    & "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

C#

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"
 +
                    "LineNumber: " + ex.Errors[i].LineNumber + "\n"
 +
                    "Source: " + ex.Errors[i].Source + "\n" +
                    "Procedure: " + ex.Errors[i].Procedure + "\n");
            }
            Console.WriteLine(errorMessages.ToString());
        }
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlException クラス
SqlException メンバ
System.Data.SqlClient 名前空間
Number
Source
State
Server
Procedure
LineNumber