SqlCeEngine クラス

SQL Server Compact エンジン オブジェクトのプロパティ、メソッド、および他のオブジェクトを表します。このクラスは継承できません。

継承階層

System.Object
  System.Data.SqlServerCe.SqlCeEngine

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

構文

'宣言
Public NotInheritable Class SqlCeEngine _
    Implements IDisposable
'使用
Dim instance As SqlCeEngine

public sealed class SqlCeEngine : IDisposable

public ref class SqlCeEngine sealed : IDisposable

[<SealedAttribute>]
type SqlCeEngine =  
    class
        interface IDisposable
    end

public final class SqlCeEngine implements IDisposable

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

コンストラクター

	名前	説明
	SqlCeEngine()	SqlCeEngine クラスの新しいインスタンスを初期化します。
	SqlCeEngine(String)	ローカル接続文字列を指定して、SqlCeEngine クラスの新しいインスタンスを初期化します。

Top

プロパティ

	名前	説明
	LocalConnectionString	SQL Server Compact データベースの接続文字列を取得または設定します。

Top

メソッド

	名前	説明
	Compact	既存のデータベース ファイルから新しいデータベース ファイルを作成し、SQL Server Compact データベース内の使用済み領域をクリアします。このメソッドは、データベースの照合順序、暗号化、またはパスワードの設定変更にも使用されます。
	CreateDatabase	新しいデータベースを作成します。
	Dispose	すべての SQL Server Compact SqlCeEngine リソースを解放します。
	Equals	(Object から継承されます。)
	Finalize	(Object から継承されます。)
	GetHashCode	(Object から継承されます。)
	GetType	(Object から継承されます。)
	MemberwiseClone	(Object から継承されます。)
	Repair	破損したデータベースを修復します。
	Shrink	空のページをファイルの末尾に移動して、ファイルを切り詰めることにより、SQL Server Compact データベース内の使用済み領域がクリアされます。
	ToString	(Object から継承されます。)
	Upgrade()	SQL Server Compact データベースを Version 3.5 から 4.0 にアップグレードします。アップグレード後、ソース データベースが暗号化されていた場合は、データベースが暗号化されます。ソース データベースが暗号化されていなかった場合、アップグレードされたデータベースは暗号化されません。
	Upgrade(String)	SQL Server Compact データベースを Version 3.5 から 4.0 にアップグレードします。接続先データベースは、接続文字列で暗号化モードが指定されていた場合、暗号化されます。データベースの照合順序は、接続文字列で大文字と小文字の区別のプロパティが true に設定されている場合、大文字と小文字が区別されます。
	Verify()	データベース内の各ページのチェックサムを再計算し、その新しいチェックサムと想定値を比較します。
	Verify(VerifyOption)	VerifyOption に基づいて、データベースの整合性を検証します。

Top

説明

SQL Server Compact は、Web サイトと Web アプリケーションのデータベースとして最適化されています。SQL Server Compact は、Web アプリケーション内に埋め込まれたデータベースとして使用するように最適化されています。SQL Server Compact は、複数ユーザーやデータの同時更新に対応した Web サイト用のデータベースとして使用できます。

SQL Server Compact は、ASP.NET Web アプリケーションの開発に使用できます。以前のバージョンの SQL Server Compact では、ASP.NET Web アプリケーションで SQL Server Compact を使用するには、フラグ SQLServerCompactEditionUnderWebHosting を設定する必要がありました。このフラグは、SQL Server Compact 4.0 では削除されています。

使用例

新しい SQL Server Compact データベースを作成する方法を次のサンプルに示します。

If File.Exists("Test.sdf") Then
   File.Delete("Test.sdf")
End If 
Dim connStr As String = "Data Source = Test.sdf; Password = <password>"

Dim engine As New SqlCeEngine(connStr)
engine.CreateDatabase()
engine.Dispose()

Dim conn As SqlCeConnection = Nothing

Try
   conn = New SqlCeConnection(connStr)
   conn.Open()

   Dim cmd As SqlCeCommand = conn.CreateCommand()
   cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)"
   cmd.ExecuteNonQuery()
Catch
Finally
   conn.Close()
End Try

if (File.Exists("Test.sdf"))
    File.Delete("Test.sdf");

string connStr = "Data Source = Test.sdf; Password = <password>";

SqlCeEngine engine = new SqlCeEngine(connStr);
engine.CreateDatabase();
engine.Dispose();

SqlCeConnection conn = null;

try {
    conn = new SqlCeConnection(connStr);
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)";
    cmd.ExecuteNonQuery();
}
catch {}
finally {
    conn.Close();
}

スレッド セーフ

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

関連項目

参照

System.Data.SqlServerCe 名前空間