SqlException クラス

定義

public ref class SqlException sealed : System::Data::Common::DbException

public ref class SqlException sealed : SystemException

public sealed class SqlException : System.Data.Common.DbException

[System.Serializable]
public sealed class SqlException : SystemException

[System.Serializable]
public sealed class SqlException : System.Data.Common.DbException

type SqlException = class
    inherit DbException

[<System.Serializable>]
type SqlException = class
    inherit SystemException

[<System.Serializable>]
type SqlException = class
    inherit DbException

Public NotInheritable Class SqlException
Inherits DbException

Public NotInheritable Class SqlException
Inherits SystemException

継承

Object

Exception

DbException

SqlException

継承

Object

Exception

SystemException

ExternalException

DbException

SqlException

継承

Object

Exception

SystemException

SqlException

属性

SerializableAttribute

例

次の例では、 を SqlException 生成し、例外を表示します。

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());
        }
    }
}

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

注釈

このクラスは、.NET Framework Data Provider for SQL Server でサーバーから生成されたエラーが発生するたびに作成されます。 (クライアント側のエラーは、標準の共通言語ランタイム例外としてスローされます)。 SqlException には常に、 の少なくとも 1 つのインスタンスが SqlError含まれています。

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

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

SQL Server によって送信される警告メッセージと情報メッセージの詳細については、「 データベース エンジンのイベントとエラー」を参照してください。 クラスは SqlException SQL Server の重大度にマップされます。

例外処理に関する一般的な情報を次に示します。 アプリケーションがクラッシュするのを防ぎ、関連するエラー メッセージをユーザーに表示できるようにするために、コードで例外をキャッチする必要があります。 データベース トランザクションを使用すると、クライアント アプリケーションでの動作 (クラッシュを含む) に関係なく、データの一貫性を確保できます。 System.Transaction.TransactionScope や BeginTransaction メソッド (System.Data.OleDb.OleDbConnection、System.Data.ODBC.ODBCConnection、System.Data.SqlClient.SqlConnection) などの機能により、プロバイダーによって発生する例外に関係なく、一貫性のあるデータが確保されます。 トランザクションは失敗する可能性があるため、エラーをキャッチしてトランザクションを再試行します。

.NET Framework 4.5 以降では、 SqlException 内部 を返すことができることに注意してください Win32Exception。

.NET Framework データ プロバイダーの例外クラスは、プロバイダー固有のエラーを報告します。 たとえば、System.Data.Odbc には OdbcException、System.Data.OleDb には OleDbException、System.Data.SqlClient には SqlException があります。 エラーの詳細の最適なレベルについては、これらの例外をキャッチし、これらの例外クラスのメンバーを使用してエラーの詳細を取得します。

プロバイダー固有のエラーに加えて、.NET Framework のデータ プロバイダー型は、System.OutOfMemoryException や System.Threading.ThreadAbortException などの .NET Framework 例外を発生させることができます。 これらの例外からの復旧が不可能な場合があります。

入力が正しくないと、.NET Framework データ プロバイダーの型で System.ArgumentException や System.IndexOutOfRangeException などの例外が発生する可能性があります。 間違ったタイミングでメソッドを呼び出すと、System.InvalidOperationException が発生する可能性があります。

そのため、一般に、プロバイダー固有の例外と共通言語ランタイムからの例外をキャッチする例外ハンドラーを記述します。 これらは、次のように階層化できます。

try {  
   // code here  
}  
catch (SqlException odbcEx) {  
   // Handle more specific SqlException exception here.  
}  
catch (Exception ex) {  
   // Handle generic ones here.  
}  

または:

try {  
   // code here  
}  
catch (Exception ex) {  
   if (ex is SqlException) {  
      // Handle more specific SqlException exception here.  
   }  
   else {  
      // Handle generic ones here.  
   }  
}  

また、.NET Framework データ プロバイダー メソッドの呼び出しが、スタック上のユーザー コードのないスレッド プール スレッドで失敗する可能性もあります。 この場合、および 非同期メソッド呼び出しを使用する場合は、これらの例外を処理し、アプリケーションの UnhandledException クラッシュを回避するために イベントを登録する必要があります。

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• SqlError
• SqlErrorCollection
• ADO.NET の概要