次の方法で共有


SqlCeError クラス

データ ソースが返す警告またはエラーに関する情報を収集します。このクラスは継承できません。

継承階層

System.Object
  System.Data.SqlServerCe.SqlCeError

名前空間:  System.Data.SqlServerCe
アセンブリ:  System.Data.SqlServerCe (System.Data.SqlServerCe.dll)

構文

'宣言
<SerializableAttribute> _
Public NotInheritable Class SqlCeError
'使用
Dim instance As SqlCeError
[SerializableAttribute]
public sealed class SqlCeError
[SerializableAttribute]
public ref class SqlCeError sealed
[<SealedAttribute>]
[<SerializableAttribute>]
type SqlCeError =  class end
public final class SqlCeError

SqlCeError 型は、以下のメンバーを公開しています。

プロパティ

  名前 説明
パブリック プロパティ ErrorParameters 最後の 3 つのエラー パラメータを取得します。SQL Server Compact は、エラー パラメータを使用して、エラーに関する詳細情報を提供します。
パブリック プロパティ HResult エラーの種類を示す HRESULT 値を返します。
パブリック プロパティ Message エラーを説明するテキストを取得します。
パブリック プロパティ NativeError SqlCeError のネイティブ エラー番号を取得します。これらのエラーの詳細については、SQL Server Compact オンライン ブックの「トラブルシューティング」セクションの「SQL Server Compact のエラー」を参照してください。
パブリック プロパティ NumericErrorParameters 最初の 3 つのエラー パラメータを取得します。SQL Server Compact は、エラー パラメータを使用して、エラーに関する詳細情報を提供します。
パブリック プロパティ Source エラーを生成したプロバイダの名前を取得します。

Top

メソッド

  名前 説明
パブリック メソッド Equals (Object から継承されます。)
プロテクト メソッド Finalize (Object から継承されます。)
パブリック メソッド GetHashCode (Object から継承されます。)
パブリック メソッド GetType (Object から継承されます。)
プロテクト メソッド MemberwiseClone (Object から継承されます。)
パブリック メソッド ToString エラー メッセージの完全なテキストを取得します。 (Object.ToString() をオーバーライドします。)

Top

説明

SqlCeError のインスタンスは、エラーが発生したときに System.Data.SqlServerCe マネージ プロバイダによって作成されます。SqlCeErrorCollection には、SqlCeError のインスタンスが 1 つ以上格納されます。

使用例

SqlCeError の一般的な使用例を次に示します。

Try
    Dim repl As New SqlCeReplication()

    ' Fill repl properites here
    ' ...
    ' SqlCeReplication may throw SqlCeException which contains a 
    ' collection of errors; SQL Mobile database engine always
    ' returns one error in the collection
    '
    repl.Synchronize()
Catch e As SqlCeException
    Dim err As SqlCeError
    For Each err In e.Errors
        ' Use SqlCeError properties if you need specific
        ' application logic depending on the error condition
        '
        If 28577 = [err].NativeError Then 'SSCE_M_SCHEMAHASCHANGED
            ' Error specific logic goes here...
            '
        End If

        ' Note: For native error numbers, refer to SQL Server Mobile Errors
        ' in the SQL Server Mobile Books Online
        '
        MessageBox.Show([err].Message)
    Next err
End Try
try
{
    SqlCeReplication repl = new SqlCeReplication();

    // Fill repl properites here
    // ...

    // SqlCeReplication may throw SqlCeException which contains a 
    // collection of errors; SQL Mobile database engine always
    // returns one error in the collection
    //
    repl.Synchronize();
}
catch (SqlCeException e)
{
    foreach (SqlCeError error in e.Errors)
    {
        // Use SqlCeError properties if you need specific
        // application logic depending on the error condition
        //
        if (28577 == error.NativeError /*SSCE_M_SCHEMAHASCHANGED*/)
        {
            // Error specific logic goes here...
            //
        }

        // Note: For native error numbers, refer to SQL Server Mobile Errors
        // in the SQL Server Mobile Books Online
        //
        MessageBox.Show(error.Message);
    }
}

スレッド セーフ

この型の public static (Microsoft Visual Basic では Shared) のすべてのメンバーは、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

関連項目

参照

System.Data.SqlServerCe 名前空間

SqlCeErrorCollection

SqlCeException