SqlCeException クラス

基になるプロバイダーが SQL Server Compact データ ソースから警告またはエラーを返したときにスローされる例外。このクラスは継承できません。

継承階層

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        System.Data.Common.DbException
          System.Data.SqlServerCe.SqlCeException
            System.Data.SqlServerCe.SqlCeInvalidDatabaseFormatException
            System.Data.SqlServerCe.SqlCeLockTimeoutException
            System.Data.SqlServerCe.SqlCeTransactionInProgressException

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

構文

'宣言
<SerializableAttribute> _
Public Class SqlCeException _
    Inherits DbException
'使用
Dim instance As SqlCeException

[SerializableAttribute]
public class SqlCeException : DbException

[SerializableAttribute]
public ref class SqlCeException : public DbException

[<SerializableAttribute>]
type SqlCeException =  
    class
        inherit DbException
    end

public class SqlCeException extends DbException

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

コンストラクター

	名前	説明
	SqlCeException	シリアル化で役立つコンストラクター。

Top

プロパティ

	名前	説明
	Data	(Exception から継承されます。)
	ErrorCode	(ExternalException から継承されます。)
	Errors	.NET Compact Framework Data Provider for SQL Server Compact が生成する例外の詳細情報を含む、1 つ以上の SqlCeError オブジェクトのコレクションを取得します。
	HelpLink	(Exception から継承されます。)
	HResult	例外の HRESULT 値を取得します。値は、例外の SqlCeErrorCollection 内にある SqlCeError の最初のインスタンスの HResult 値と同じです。
	InnerException	(Exception から継承されます。)
	Message	この例外の SqlCeErrorCollection 内にある SqlCeError の最初のインスタンスの説明テキストを取得します。 (Exception.Message をオーバーライドします。)
	NativeError	SqlCeErrorCollection 内の最初の SqlCeError のネイティブ エラー番号を取得します。エラーの詳細については、SQL Server Compact オンライン ブックの「トラブルシューティング」セクションの「SQL Server Compact のエラー」のトピックを参照してください。
	Source	エラーを生成した OLE DB プロバイダーの名前を取得します。 (Exception.Source をオーバーライドします。)
	StackTrace	(Exception から継承されます。)
	TargetSite	(Exception から継承されます。)

Top

メソッド

	名前	説明
	Equals	(Object から継承されます。)
	Finalize	(Object から継承されます。)
	GetBaseException	(Exception から継承されます。)
	GetHashCode	(Object から継承されます。)
	GetObjectData	セキュリティ クリティカル。オブジェクトのシリアル化に必要なデータを SerializationInfo に格納します。 (Exception.GetObjectData(SerializationInfo, StreamingContext) をオーバーライドします。)
	GetType	(Exception から継承されます。)
	MemberwiseClone	(Object から継承されます。)
	ToString	(Exception から継承されます。)

Top

説明

このクラスは、SQL Server Compact エンジンで生成されたエラーを .NET Compact Framework Data Provider for SQL Server Compact が検出するたびに作成されます。他のエラーは、標準の共通言語ランタイム例外としてスローされます。SqlCeException には、常に、SqlCeError のインスタンスが少なくとも 1 つ含まれています。

使用例

データ ソースが見つからないために発生する SqlCeException を生成し、その例外を表示する例を次に示します。

Dim conn As New SqlCeConnection("Data Source=nonExistingSource.sdf;")

Try
    conn.Open()
Catch e As SqlCeException
    ' Use SqlCeException properties if you need specific
    ' application logic depending on the error condition
    '
    If 25046 = e.NativeError Then 'SSCE_M_FILENOTFOUND
        ' Error specific logic goes here...
        '
    End If

    MessageBox.Show(e.Message)
End Try

SqlCeConnection conn = new SqlCeConnection("Data Source=nonExistingSource.sdf;");

try
{
    conn.Open();
}
catch (SqlCeException e)
{
    // Use SqlCeException properties if you need specific
    // application logic depending on the error condition
    //
    if (25046 == e.NativeError /*SSCE_M_FILENOTFOUND*/)
    {
        // Error specific logic goes here...
        //
    }

    MessageBox.Show(e.Message);
}

スレッド セーフ

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

関連項目

参照

System.Data.SqlServerCe 名前空間

SqlCeError

SqlCeErrorCollection