デスクトップ用アプリケーションの構築 (SQL Server Compact)

[アーティクル]
01/17/2011

SQL Server Compact 3.5 は、コンピューターアプリケーションのデータストアとして使用できます。このトピックでは、SQL Server Compact 3.5 を Visual Studio 製品に追加し、System.Data.SqlServerCe 名前空間でコードを記述する方法について説明します。System.Data.SqlServerCe 名前空間のマネージリファレンストピックは、.NET Framework リファレンスドキュメントにあります。

コンピュータプロジェクトの作成

新しいコンピュータアプリケーションを作成するには、最初に Visual Studio で Windows プロジェクトを作成します。コンピュータアプリケーションの場合は、次に Microsoft.Ink 名前空間への参照を追加する必要があります。

注意

Windows XP Tablet PC Edition コンピュータ上で Tablet PC アプリケーションを開発する場合以外は、まず、Microsoft Windows XP Tablet PC Edition Development Kit をインストールする必要があります。最新版は、モバイルアプリケーションおよび埋め込みアプリケーションデベロッパーセンターからダウンロードできます。

新しいコンピュータプロジェクトを作成するには

Visual Studio の [ファイル] メニューで、[新規作成] をポイントし、[プロジェクト] をクリックします。
[新しいプロジェクト] ダイアログボックスの [インストールされているテンプレート] の一覧で、使用するプログラミング言語を展開し、[Windows] をクリックします。
[テンプレート] の一覧で、[Windows フォームアプリケーション] をクリックします。
プロジェクトの名前と場所を指定し、[OK] をクリックします。

Visual Studio によって新しいプロジェクトが作成され、メインフォーム (Form1) が表示されます。
(オプション) ソリューションエクスプローラで、[参照設定] を右クリックし、[参照の追加] をクリックします。

注意

ソリューションエクスプローラーに [参照設定] フォルダーが表示されていない場合は、ソリューションエクスプローラーの上部の [すべてのファイルを表示] をクリックします。
(オプション) .NET アセンブリの一覧で、[Microsoft Tablet PC API] をクリックし、[OK] をクリックします。

参照設定の一覧に、[Microsoft.Ink] が追加されているはずです。

中心配置用に構築する際のプロジェクトへの SQL Server Compact 3.5 の追加

プロジェクトを作成した後、SQL Server Compact 3.5 アセンブリへの参照を追加する必要があります。アプリケーションを構築する際の SQL Server Compact 3.5 アセンブリへの参照の追加手順は、アプリケーションが SQL Server Compact 3.5 のプライベート配置用か、中心配置用かによって多少異なります。中心配置用では、次の手順に従います。

中心配置用に SQL Server Compact 3.5 への参照を追加するには

ソリューションエクスプローラーで、[参照設定] を右クリックし、[参照の追加] をクリックします。

注意

ソリューションエクスプローラーに [参照設定] フォルダーが表示されていない場合は、ソリューションエクスプローラーの上部の [すべてのファイルを表示] をクリックします。
.NET アセンブリの一覧で [System.Data.SqlServerCe] をクリックし、[OK] をクリックします。System.Data.SqlServerCe が表示されない場合、次の手順を実行します。
1. [参照の追加] ダイアログボックスの [参照] をクリックします。
2. フォルダー (%Program Files%\Microsoft SQL Server Compact Edition\v3.5\Desktop) に移動します。
3. [System.Data.SqlServerCe.dll] をクリックし、[OK] をクリックします。
ソリューションエクスプローラーの参照設定の一覧に System.Data.SqlServerCe が追加され、このアセンブリをプロジェクトで使用できるようになりました。

注意

プロジェクトで Entity Framework を使用する場合、同じ手順を繰り返して System.Data.SqlServerCe.Entity への参照を追加します。.NET アセンブリの一覧から System.Data.SqlServerCe.Entity を追加することも、%Program Files%\Microsoft SQL Server Compact Edition\v3.5 を参照することもできます。
ソリューションエクスプローラーで [Form1.cs] または [Form1.vb] を右クリックし、[コードの表示] をクリックします。
フォームのコードの先頭に System.Data.SqlServerCe 名前空間を使用するディレクティブを追加します。Entity Framework を使用する場合は、System.Data.SqlServerCe 名前空間を使用するディレクティブを追加します。Tablet PC アプリケーションの場合は、Tablet PC API を使用するディレクティブも追加します。
- C#
```
using System.Data.SqlServerCe;
using System.Data.SqlServerCe.Entity; 
using Microsoft.Ink;
```
- Visual Basic
```
Imports System.Data.SqlServerCe
Imports System.Data.SqlServerCe.Entity
Imports Microsoft.Ink
```

プライベート配置用に構築する際のプロジェクトへ SQL Server Compact 3.5 の追加

プロジェクトを作成した後、SQL Server Compact 3.5 アセンブリへの参照を追加する必要があります。アプリケーションを構築する際の SQL Server Compact 3.5 アセンブリへの参照の追加手順は、アプリケーションが SQL Server Compact 3.5 のプライベート配置用か、中心配置用かによって多少異なります。プライベート配置用では、次の手順に従います。

中心配置用に SQL Server Compact 3.5 への参照を追加するには

ソリューションエクスプローラーで、[参照設定] を右クリックし、[参照の追加] をクリックします。

注意

ソリューションエクスプローラーに [参照設定] フォルダーが表示されていない場合は、ソリューションエクスプローラーの上部の [すべてのファイルを表示] をクリックします。
[参照の追加] ダイアログボックスの [参照] をクリックします。
フォルダー (%Program Files%\Microsoft SQL Server Compact Edition\v3.5\Private) に移動します。
System.Data.SqlServerCe をクリックし、[OK] をクリックします。

ソリューションエクスプローラーの参照設定の一覧に System.Data.SqlServerCe が追加され、このアセンブリをプロジェクトで使用できるようになりました。

注意

プロジェクトで Entity Framework を使用する場合、同じ手順を繰り返して System.Data.SqlServerCe.Entity への参照を追加します (プライベート配置の場合、System.Data.SqlServerCe.Entity は %Program Files%\Microsoft SQL Server Compact Edition\v3.5\Private フォルダーからも追加されます)。
ソリューションエクスプローラーで [Form1.cs] または [Form1.vb] を右クリックし、[コードの表示] をクリックします。
フォームのコードの先頭に System.Data.SqlServerCe 名前空間を使用するディレクティブを追加します。Entity Framework を使用する場合は、System.Data.SqlServerCe 名前空間を使用するディレクティブを追加します。Tablet PC アプリケーションの場合は、Tablet PC API を使用するディレクティブも追加します。
- C#
```
using System.Data.SqlServerCe;
using System.Data.SqlServerCe.Entity; 
using Microsoft.Ink;
```
- Visual Basic
```
Imports System.Data.SqlServerCe
Imports System.Data.SqlServerCe.Entity
Imports Microsoft.Ink
```

プライベート配置用の SQL Server Compact の構成

SQL Server Compact 3.5 のプライベート配置を使用するアプリケーションを構築するには、.NET Framework データプロバイダーと必要なネイティブ DLL がアプリケーションの出力ディレクトリに配置されている必要があります。アプリケーションで SQL Server Compact 3.5 のプライベート配置を使用する場合は、このセクションの手順に従います。アプリケーションでプライベート配置を使用しない場合は、このセクションを省略してください。SQL Server Compact 3.5 のプライベート配置の詳細については、「プライベート配置と中心配置 (SQL Server Compact)」を参照してください。次の手順では、アプリケーションが任意のプラットフォーム (32 ビットと 64 ビット) を対象として構築されることを前提としています。アプリケーションがこれらのプラットフォームのどちらかを対象としている場合は、他のプラットフォームに該当する手順を省略できます。

SQL Server Compact のプライベート配置用にアプリケーションを構成するには

プロジェクトの構築時に出力ディレクトリにコピーされるように、.NET Framework Data Provider for SQL Server Compact 3.5 アセンブリを構成します。
1. ソリューションエクスプローラーで、[参照設定] を展開して、System.Data.SqlServerCe を右クリックし、[プロパティ] をクリックします。
2. System.Data.SqlServerCe の [参照プロパティ] で、[ローカルコピー] を True に設定します。
注意

プロジェクトで Entity Framework を使用する場合は、System.Data.SqlServerCe.Entity の場合と同じ手順を繰り返して、出力ディレクトリにコピーされるように Entity Framework Data Provider for SQL Server Compact 3.5 を構成します。
必要な 32 ビットの SQL Server Compact 3.5 ネイティブライブラリをプロジェクトに追加します。
1. ソリューションエクスプローラーで、プロジェクトを右クリックし、[追加] をポイントして、[新しいフォルダー] をクリックします。フォルダーに「x86」という名前を付けます。
2. ソリューションエクスプローラーで、x86 フォルダーを右クリックし、[追加] をポイントして、[既存の項目] をクリックします。
3. [既存項目の追加] ダイアログボックスで、32 ビットのネイティブライブラリが配置されたフォルダーを参照します。Windows の 32 ビットバージョンの場合、このフォルダーは %Program Files%\Microsoft SQL Server Compact Edition\v3.5 です。Windows の 64 ビットバージョンの場合、このフォルダーは %Program Files (x86)%\Microsoft SQL Server Compact Edition\v3.5 です。
4. プロジェクトに必要な各ネイティブライブラリをコントロールクリックしてファイル一覧でそれらを選択し、[OK] をクリックします。ライブラリは、x86 フォルダーに追加されます。
  
  注意
  
  少なくとも、sqlceme35.dll、sqlceqp35.dll、sqlcese35.dll、および sqlceer35.dll のライブラリを追加する必要があります。
必要な 64 ビットの SQL Server Compact 3.5 ネイティブライブラリをプロジェクトに追加します。
1. ソリューションエクスプローラーで、プロジェクトを右クリックし、[追加] をポイントして、[新しいフォルダー] をクリックします。フォルダーに「x64」という名前を付けます。
2. ソリューションエクスプローラーで、x64 フォルダーを右クリックし、[追加] をポイントして、[既存の項目] をクリックします。
3. [既存項目の追加] ダイアログボックスで、64 ビットのネイティブライブラリが配置されたフォルダーを参照します。Windows の 64 ビットバージョンの場合、このフォルダーは %Program Files%\Microsoft SQL Server Compact Edition\v3.5 です。
  
  注意
  
  Windows の 32 ビットバージョンを実行しているコンピューターに SQL Server Compact 3.5 の 64 ビットバージョンをインストールすることはできません。32 ビット開発環境で構築されるプロジェクトに 64 ビットのネイティブライブラリを追加するには、まず、開発コンピューターで 64 ビットインストーラーからディレクトリにファイルを抽出する必要があります。抽出したら、このディレクトリを参照して、プロジェクトに 64 ビットネイティブライブラリを追加できます。インストーラーからファイルを抽出する方法の詳細については、「方法: 64 ビット版の DLL を SQL Server Compact ランタイムインストーラーから抽出する」を参照してください。
4. プロジェクトに必要な各ネイティブライブラリをコントロールクリックしてファイル一覧でそれらを選択し、[OK] をクリックします。ライブラリは、x64 フォルダーに追加されます。
  
  注意
  
  少なくとも、sqlceme35.dll、sqlceqp35.dll、sqlcese35.dll、および sqlceer35.dll のライブラリを追加する必要があります。
プロジェクトの構築時に出力ディレクトリにコピーされるように、前の手順で追加した各ネイティブライブラリを構成します。両方のディレクトリのライブラリでこの操作を行う必要があります。
1. ソリューションエクスプローラーで、ライブラリ (たとえば、sqlcese35.dll) を右クリックし、[プロパティ] をクリックします。
  
  注意
  
  ソリューションエクスプローラーにアセンブリが表示されていない場合は、ソリューションエクスプローラーの上部の [すべてのファイルを表示] をクリックします。
2. ファイルの [プロパティ] の [出力ディレクトリにコピー] ドロップダウンリストで [常にコピーする] または [新しい場合はコピーする] をクリックします。
任意の CPU に対して構築するようにプロジェクトを構成します。
1. ソリューションエクスプローラーで、プロジェクトを右クリックし、[プロパティ] をクリックして、プロジェクトデザイナーを開きます。
2. [構築] をクリックし、[プラットフォームターゲット] ドロップダウンリストで [任意の CPU] をクリックします。

SQL Server Compact 3.5 オブジェクトの使用

System.Data.SqlServerCe 名前空間を追加すると、その名前空間で、SQL Server Compact 3.5 オブジェクトを使用してコードを作成できます。次のコード例は、Engine オブジェクトを使用して SQL Server Compact 3.5 データベースファイルを新規作成する方法を示しています。

using System;
using System.Data.SqlServerCe;
using System.IO;

public class MySqlCeEngine
{
    public void CreateDB()
    {
        File.Delete("Test.sdf");
        string connString = "Data Source='Test.sdf'; LCID=1033;   Password=<enterStrongPasswordHere>; Encrypt = TRUE;";
        SqlCeEngine engine = new SqlCeEngine(connString);
        engine.CreateDatabase();
    }
}

Imports System
Imports System.Data.SqlServerCe
Imports System.IO

Public Class MySqlCeEngine

    Public Sub CreateDB()
        File.Delete("Test.sdf")
        Dim connString As String = "Data Source='Test.sdf'; LCID=1033; Password=<enterStrongPasswordHere>; Encrypt = TRUE;"
        Dim engine As New SqlCeEngine(connString)
        engine.CreateDatabase()
    End Sub
End Class

次の方法で共有

デスクトップ用アプリケーションの構築 (SQL Server Compact)

コンピュータプロジェクトの作成

新しいコンピュータプロジェクトを作成するには

中心配置用に構築する際のプロジェクトへの SQL Server Compact 3.5 の追加

中心配置用に SQL Server Compact 3.5 への参照を追加するには

プライベート配置用に構築する際のプロジェクトへ SQL Server Compact 3.5 の追加

中心配置用に SQL Server Compact 3.5 への参照を追加するには

プライベート配置用の SQL Server Compact の構成

SQL Server Compact のプライベート配置用にアプリケーションを構成するには

SQL Server Compact 3.5 オブジェクトの使用

関連項目

参照

その他のリソース

次の方法で共有

デスクトップ用アプリケーションの構築 (SQL Server Compact)

コンピュータ プロジェクトの作成

新しいコンピュータ プロジェクトを作成するには

中心配置用に構築する際のプロジェクトへの SQL Server Compact 3.5 の追加

中心配置用に SQL Server Compact 3.5 への参照を追加するには

プライベート配置用に構築する際のプロジェクトへ SQL Server Compact 3.5 の追加

中心配置用に SQL Server Compact 3.5 への参照を追加するには

プライベート配置用の SQL Server Compact の構成

SQL Server Compact のプライベート配置用にアプリケーションを構成するには

SQL Server Compact 3.5 オブジェクトの使用

関連項目

参照

その他のリソース

コンピュータプロジェクトの作成

新しいコンピュータプロジェクトを作成するには