Oracle Database 11gまたはOracle Database 10gをインストールし、データベースを作成してあること。

Visual Studio .NET 2003以上をインストールしてあること。

Oracle Database ClientまたはOTNから、ODP.NET 11gをインストールしてあること。

Windowsのプログラム・メニューから、Visual Studioを起動します。 Microsoft Visual Studio GUI環境が表示されます。 Recent Projectsパネルで、Create:の横にある「Project」をクリックします。

New Projectウィンドウが表示されます。

Project typesリストから、「Visual C#: Windows」を選択します。 「Windows Application」テンプレートを選択します。 Nameフィールドに、OraWinAppと入力します。Locationフィールドで、ファイルを保存するディレクトリを指定します。 （注：ディレクトリが存在しない場合は、自動で作成されます。） 「OK」をクリックします。

これで、プロジェクトが作成されました。 Viewメニューから、「Solution Explorer」を選択してSolution Explorerを開きます（まだ開いていない場合）。

Projectメニューから、「Add Reference...」を選択します。

Add Referenceダイアログ・ボックスが表示されます。

コンポーネント名のリストを下方向にスクロールして、「Oracle.DataAccess」を選択します。 「OK」をクリックします。

注：Oracle.DataAccessコンポーネントが複数表示されている場合は、バージョン'2.102.2.20'を選択します。

Viewメニューから「Toolbox」を選択します。 ツールボックスが表示されます。 「Common Controls」を開きます。

「Button」コントロールをForm1キャンバスにドラッグします。

キャンバスにコントロールが表示されます。 ラベルも作成する必要があります。

ツールボックスから、「Label」コントロールをForm1キャンバスにドラッグします。

「button1」をダブルクリックして、コード・ウィンドウを開きます。 Form1.csコード・ウィンドウが開きます。

以下のC# using文を、Public Class宣言の前に追加します。

using Oracle.DataAccess.Client; // ODP.NET Oracle managed provider
using Oracle.DataAccess.Types; 

以下のC#コードをprivate void button1_Click(object sender, EventArgs e)
{と、}の間に追加します。

string oradb = "Data Source=ORCL;User Id=hr;Password=hr;";
OracleConnection conn = new OracleConnection(oradb);  // C#
conn.Open(); 
OracleCommand cmd = new OracleCommand();
cmd.Connection = conn;
cmd.CommandText = "select department_name from departments where department_id = 10";
cmd.CommandType = CommandType.Text; 
OracleDataReader dr = cmd.ExecuteReader();
dr.Read();
label1.Text = dr.GetString(0);
conn.Dispose();

「Build」→「Build Solution」を選択します。

出力ウィンドウで、エラーがないことを確認します。 これで、フォームを実行できます。

「Debug」→「Start Without Debugging」を選択します。

フォームが表示されます。 「button1」をクリックします。

結果がラベルに表示されます。 コード内の問合せは、DEPARTMENT_IDが10の部門名を表示するためのものだったので、結果はAdministration部門になります。 Form1を閉じます。

「Form1.cs [Design] 」タブを選択します。 ツールボックスから、「TextBox」コントロールをForm1キャンバスにドラッグします。

テキスト・ボックスが表示されます。 このボックスは、好きな場所にドラッグできます。

「Label」コントロールをForm1キャンバスにドラッグします。

ラベルが表示されます。 「Label2」を右クリックして、「Properties」を選択します。

Propertiesシートで、テキスト・プロパティをEnter Department ID:に変更します。

「Form1.cs」タブを選択します。

バインド変数を使用して、テキスト・ボックスの値をSELECT文の一部に含めます。 バインド変数を使用すると、テキスト・ボックスの値が変わるたびに、データベースでSQL文を再解析する必要がなくなるので、パフォーマンスが向上します。

次のコードをconn.Open()文のすぐあとに追加します。

OracleParameter parm = new OracleParameter();
parm.OracleDbType = OracleDbType.Decimal;
parm.Value = textBox1.Text;

cmd.Parameters文をcmd.Connection文のすぐあとに追加します。

cmd.Parameters.Add(parm);

cmd.CommandText文のコードを次のように変更します。

cmd.CommandText = "select department_name from departments where department_id = :1";

「Build」→「Rebuild Solution」を選択します。

出力ウィンドウでエラーがないことを確認します。 エラーも警告もない場合は、次の手順に進みます。

「Debug」→「Start Without Debugging」を選択します。

Department IDに20と入力して、「button1」をクリックします。

Label1が部門名に変わることを確認します。 部門名は、Department IDフィールドに入力した値によって異なります。

Department IDに300と入力して、「button1」をクリックします。

IDが300の部門はないため、今回はエラーが表示されます。「Quit」をクリックします。 次のトピックでは、エラー処理を追加して、エラーが発生した理由を正確に把握できるようにします。

Form1.csウィンドウで、次のコードを変更します。

dr.Read();
label1.Text = dr.GetString(0);

から

if (dr.Read())
{
   label1.Text = dr.GetString(0);
}
else 
{
   label1.Text = "Department ID not found";
};

「Build」→「Rebuild Solution」を選択します。 出力ウィンドウでエラーがないことを確認します。

「Debug」→「Start Without Debugging」を選択します。

Department IDにもう一度300と入力して、「button1」をクリックします。

今回は、Department ID not foundというメッセージが表示されます。 Form1を閉じます。

「Form1.cs [Design]」タブをクリックします。 ツールボックスから、「Listbox」コントロールをForm 1キャンバスにドラッグします。

フォームに新しいリストボックスが表示されます。 リストボックスの配置とサイズ変更を適切におこなうことができます。 「Form1.cs」タブをクリックします。

cmd.Parameters.Add(parm);文を削除します。

次のcmd.CommandTextコードを変更します。

cmd.CommandText = "select department_name from departments where department_id = :1";

から

cmd.CommandText = "select department_id, department_name, city" 
                  + " from departments d, locations l" 
                  + " where d.location_id = l.location_id";

以下の一連のコードも変更します。

if (dr.Read())          
{
  label1.Text = dr.GetString(0);
}
else 
{
  label1.Text = "Department ID not found";
};

から

while (dr.Read()) 
{ 
   listBox1.Items.Add("The " + dr.GetString(1) 
         + " department is in " + dr.GetString(2));
}

「Build」→「Rebuild Solution」を選択します。

「Debug」→「Start Without Debugging」を選択します。

「button1」をクリックします。

リストにすべての部門とそれぞれの場所が表示されます。 Form1を閉じます。