SQL Server Compact Edition エラー オブジェクトの使用

このトピックでは、Microsoft .NET Compact Framework Data Provider for SQL Server 2005 Compact Edition (SQL Server Compact Edition) によって提供されるエラー オブジェクトの使用方法を示すコード例を紹介します。これらのオブジェクトを使用すると、Replication オブジェクト、RemoteDataAccess オブジェクト、または Engine オブジェクトの各メソッドの実行時に SQL Server Compact Edition で発生するエンジン エラーをキャプチャして表示できます。

SqlCeException オブジェクト

エンジン エラーが発生すると、SqlCeException オブジェクトが作成されます。この例外オブジェクトには、SqlCeErrorCollection オブジェクトが含まれます。このオブジェクトは、例外の各エラーに対して 1 つの SqlCeError オブジェクトを含むコレクションです。SqlCeErrorCollection オブジェクトには、SqlCeException.Errors プロパティを使用して直接アクセスできます。各 SqlCeError オブジェクトには、エラーに関する詳細情報を設定するエラー パラメータが含まれます。SQL Server と異なり、SQL Server Compact Edition はエラーに関する詳細情報をパラメータのコレクションとして返します。エラー メッセージを作成するときは、一連の FOR ループを入れ子にして、コレクション内の各 SqlCeError オブジェクトに含まれるパラメータを取得することをお勧めします。

詳細については、「SQL Server Compact Edition の .NET プログラミング」を参照してください。

例

次の例では、ShowSqlException メソッドで SQL Server Compact Edition エンジンの例外エラーをキャッチしています。この SqlCeException オブジェクトは、ShowErrors メソッドに渡されます。このメソッドは、SqlCeErrorCollection オブジェクトに含まれる各 SSCEError オブジェクトを表示します。このメソッドでは、各エラーのエラー パラメータすべてをループ処理します。

C#

// Reference the .NET Compact Framework Data Provider for SQL Server Compact Edition.
using System.Data.SqlServerCe;

// Start the method to generate a SQL Server Compact Edition engine exception.
public void ShowSqlCeException() 
{
    string mySelectQuery = "SELECT column1 FROM table1";
    SqlCeConnection myConnection = new SqlCeConnection("Data Source=nonExistSource.sdf;");
    SqlCeCommand myCommand = new SqlCeCommand(mySelectQuery,myConnection);

    try 
    {
        myCommand.Connection.Open();
    }

    // Catch the exception as e and pass it to the ShowErrors routine.
    catch (SqlCeException e) 
    {
        ShowErrors(e);
    }

}

// Error handling routine that generates an error message
public static void ShowErrors(SqlCeException e) 
{
    SqlCeErrorCollection errorCollection = e.Errors;

    StringBuilder bld = new StringBuilder();
    Exception inner = e.InnerException;

    if (null != inner) 
    {
        MessageBox.Show("Inner Exception: " + inner.ToString());
    }
    // Enumerate the errors to a message box.
    foreach (SqlCeError err in errorCollection) 
    {
        bld.Append("\n Error Code: " + err.HResult.ToString("X")); 
        bld.Append("\n Message   : " + err.Message);
        bld.Append("\n Minor Err.: " + err.NativeError);
        bld.Append("\n Source    : " + err.Source);

        // Enumerate each numeric parameter for the error.
        foreach (int numPar in err.NumericErrorParameters) 
        {
            if (0 != numPar) bld.Append("\n Num. Par. : " + numPar);
        }

        // Enumerate each string parameter for the error.
        foreach (string errPar in err.ErrorParameters) 
        {
            if (String.Empty != errPar) bld.Append("\n Err. Par. : " + errPar);
        }

        MessageBox.Show(bld.ToString());
        bld.Remove(0, bld.Length);
    }
}

Visual Basic

' Reference the  .NET Compact Framework Data Provider for SQL Server Compact Edition by using the Imports directive.
Imports System.Data.SqlServerCe

' Start the method to generate a SQL Server Compact Edition engine exception.
Public Sub ShowSqlCeException()
    Dim mySelectQuery As String = "SELECT column1 FROM table1"
    Dim myConnection As New SqlCeConnection("Data Source=nonExistSource.sdf;")
    Dim myCommand As New SqlCeCommand(mySelectQuery, myConnection)

    Try
        myCommand.Connection.Open()

    ' Catch the exception as e and pass it to the ShowErrors routine.
    Catch e As SqlCeException

        ShowErrors(e)

    End Try
End Sub

' Error handling routine that generates an error message
Public Shared Sub ShowErrors(ByVal e As SqlCeException)
    Dim errorCollection As SqlCeErrorCollection = e.Errors

    Dim bld As New StringBuilder()
    Dim inner As Exception = e.InnerException

    If Not inner Is Nothing Then
        MessageBox.Show(("Inner Exception: " & inner.ToString()))
    End If

    Dim err As SqlCeError

    ' Enumerate each error to a message box.
    For Each err In errorCollection
        bld.Append((ControlChars.Cr & " Error Code: " & err.HResult.ToString("X")))
        bld.Append((ControlChars.Cr & " Message   : " & err.Message))
        bld.Append((ControlChars.Cr & " Minor Err.: " & err.NativeError))
        bld.Append((ControlChars.Cr & " Source    : " & err.Source))

        ' Retrieve the error parameter numbers for each error.
        Dim numPar As Integer
        For Each numPar In err.NumericErrorParameters
            If 0 <> numPar Then
                bld.Append((ControlChars.Cr & " Num. Par. : " & numPar))
            End If
        Next numPar

        ' Retrieve the error parameters for each error.
        Dim errPar As String
        For Each errPar In err.ErrorParameters
            If [String].Empty <> errPar Then
                bld.Append((ControlChars.Cr & " Err. Par. : " & errPar))
            End If
        Next errPar

        MessageBox.Show(bld.ToString())
        bld.Remove(0, bld.Length)
    Next err
End Sub

参照

ヘルプおよび情報

SQL Server Compact Edition のサポートについて