チュートリアル : パラメータ クエリ アプリケーション
更新 : 2007 年 11 月
このチュートリアルでは、Visual Studio 環境を使用して、簡単なパラメータ クエリ アプリケーションを開発する方法について説明します。データ連結とユーザー インターフェイスは自動的に生成されます。このアプリケーションは既存の Northwind データベースを元に作成され、スマート デバイス ユーザーが [Order Number] しかわからないときに [Shipping Country] を判断できる機能を備えています。ここで構築するアプリケーションには、[Order Number] のユーザー入力機能と、対応する [Shipping Country] の結果表示機能があります。
.gif "メモ") メモ : |
|---|
お使いのマシンで、Visual Studio ユーザー インターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。 |
このチュートリアルは、[Visual Basic 開発設定] と [Visual C# 開発設定] を使用して記述されています。
前提条件
SQL Server Compact 3.5 用の Northwind データベースは、Visual Studio に付属しています
| メモ : |
|---|
開発用コンピュータの管理者でない場合は、既定の位置 (drive:\Program Files\Microsoft SQL Server Compact Edition\v3.5\Samples) にある Northwind.sdf ファイルを開くことができません。指示に従って、ファイルをデスクトップまたは [マイ ドキュメント] にコピーして開いてください。 |
対象デバイスの選択
ソリューションを配置するときにデバイス選択のダイアログが表示されるようにするには、次の手順を実行します。
配置時にデバイス選択のダイアログを表示するには
[ツール] メニューの [オプション] をクリックし、[デバイス ツール] を展開します。次に、[全般] をクリックします。
[デバイス プロジェクトの配置前に選択できるデバイスを表示] チェック ボックスをオンにします。
アプリケーションの作成
これは、このチュートリアルのデータ機能をホストする Windows フォームのサンプル アプリケーションです。
Windows フォームのデバイス プロジェクトを作成するには
(Visual Basic) Visual Studio で [ファイル] メニューの [新しいプロジェクト] をクリックします。
または
(Visual C#) Visual Studio で [ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
[プロジェクトの種類] ペインで、[Visual Basic] または [Visual C#] を展開し、[スマート デバイス] をクリックします。次に、[テンプレート] ペインで、[スマート デバイス プロジェクト] をクリックし、[名前] ボックスに「ParamQuerySample」と入力し、[OK] をクリックします。
[新しいスマート デバイス プロジェクトの追加] ダイアログ ボックスで、[ターゲット プラットフォーム] ボックスの一覧の [Pocket PC 2003] をクリックします。次に、[デバイス アプリケーション] をクリックし、[OK] をクリックします。
Windows フォーム デザイナに Pocket PC デバイスが表示されます。
データ機能の追加
ここでは、次の作業を行います。
データ ソースの種類の選択。
データ接続の選択と構成。
データベース オブジェクトの選択。
フォームにデータ連結コントロールを追加。
データ ソースの種類を選択するには
[データ] メニューで、[新しいデータ ソースの追加] をクリックし、データ ソース構成ウィザードを起動します。
[データソースの種類を選択] ページで、[データベース] を選択し、[次へ] をクリックします。
データ接続の選択と構成を行うには
[データ接続の選択] ページの [新しい接続] をクリックします。
[データ ソースの選択] ダイアログ ボックスで、[Microsoft SQL Server Compact 3.5] をクリックし、[続行] をクリックします。
メモ :設定や前のプロジェクトによっては、[データ ソースの選択] ダイアログ ボックスではなく、[接続の追加] ダイアログ ボックスが表示されることがあります。この場合、[接続の追加] ダイアログ ボックスの [変更] をクリックすると、[データ ソースの変更] ダイアログ ボックスが表示されます。[Microsoft SQL Server Compact 3.5] を選択し、[OK] をクリックします。
[接続の追加] ダイアログ ボックスで、[マイ コンピュータ] を選択します。
[接続の追加] ダイアログ ボックスで、[参照] をクリックします。
[SQL Server Compact 3.5 データベース ファイルの選択] ダイアログ ボックスで、[Northwind.sdf] を選択し、[開く] をクリックします。
[接続の追加] ダイアログ ボックスの [パスワード] ボックスは空のままにします。
このデータベースにはパスワードがありません。
.gif "セキュリティに関するメモ")
セキュリティに関するメモ :実際のアプリケーションで使用されるデータベース用の強力なパスワードを使用してください。
[接続の確認] をクリックして接続を確認します。
メモ :Northwind.sdf ファイルへのアクセスが拒否された場合、ファイルをデスクトップにコピーして、そのコピーを開きます。この問題は、開発コンピュータ上で既定の位置にあるファイルを開くのに十分なアクセス権がないときに発生します (既定の位置については、このチュートリアルの最初の説明を参照してください)。
接続の成功を示すメッセージ ボックスの [OK] をクリックし、[接続の追加] ダイアログ ボックスの [OK] をクリックして、ダイアログ ボックスを閉じます。
[データ接続の選択] ページの [次へ] をクリックします。
ファイルをプロジェクトにコピーするかどうかを確認するメッセージ ボックスに対して、[はい] をクリックします。
データベース オブジェクトを選択するには
[データベース オブジェクトの選択] ページで、[テーブル] を展開し、[Orders] テーブルを選択します。
[完了] をクリックします。
NorthwindDataset が作成されます。このデータ ソースは、[データ] メニューの [データ ソースの表示] をクリックすると表示されます。
クエリを作成するには
[データ ソース] ウィンドウで、[Orders] テーブルを展開します。
[Ship Country] 列をクリックし、ドロップダウン矢印をクリックして、[ラベル] オプションを選択します。
[Ship Country] 列をデザイナのフォームにドラッグします。
デザイナのラベル コントロールで、スマート タグをクリックし、[クエリの追加] をクリックします。
[検索条件ビルダ] ダイアログ ボックスで、[クエリ ビルダ] をクリックします。
[Order ID] 行の [フィルタ] 列に、疑問符 (?) を入力します。
この記号は、アプリケーションのユーザーが [Order ID] の値を入力する必要があることを示します。
[OK] をクリックします。
[クエリ テキスト] ボックスの WHERE 句は、([Order ID]=@PARAM1) になります。
[OK] をクリックして [検索条件ビルダ] ダイアログ ボックスを閉じます。
パネルがデザイナのフォーム上に表示されます。
ユーザー インターフェイスを調整するには
デザイナの [PARAM1] ラベル コントロールを右クリックし、[プロパティ] をクリックします。
または
[プロパティ] ウィンドウで [Param1Label] コントロールをクリックします。
[Text] プロパティを「Order ID」に変更します。
[FillBy] をクリックし、テキストのプロパティを [Show country] に変更します。
スクロール バーが表示されないようにパネルとコントロールを展開し、すべてのテキストを表示します。Ship_CountryLabel とそのテキスト ボックスが FillByPanel とそのコントロールに隠れないように注意してください。
アプリケーションのテスト
このセクションでは、アプリケーションを構築して Pocket PC 2003 SE エミュレータにダウンロードし、アプリケーションが正常に機能することを確認します。
アプリケーションをテストするには
[デバッグ] メニューの [開始] または [デバッグ開始] をクリックします。
[配置] ダイアログ ボックスで、[Pocket PC 2003 SE エミュレータ] を選択し、[配置] をクリックします。
配置の進行状況がステータス バーに表示されます。エミュレータへの配置には時間がかかることがあります。
アプリケーションがエミュレータで実行されたら、注文番号を入力します。Northwind データベースでこの番号は、10000 ～ 11077 です。次に [Show country] をクリックします。
その注文の [Ship Country] がラベル コントロールに表示されます。
他のチュートリアルの準備
他のチュートリアルを実行する場合、または他のプロジェクトを開く場合、エミュレータをシャットダウンし、このソリューションを終了できます。
エミュレータとソリューションを終了するには
エミュレータの [ファイル] メニューで、[終了] をクリックします。
[デバイス エミュレータ] メッセージ ボックスで、エミュレータの状態を保存する確認メッセージが表示された場合は、[いいえ] をクリックします。
(Visual Basic) [ファイル] メニューの [プロジェクトを閉じる] をクリックします。
または
(Visual C#) [ファイル] メニューの [ソリューションを閉じる] をクリックします。
プロジェクトまたはソリューションの保存を確認するメッセージが表示された場合、後で再利用するには [保存] をクリックします。保存しない場合は [破棄] をクリックします。