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