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

Visual Studio 2005 with Visual C#をインストールしてあること。

Oracle Database 11gクライアントを使用してODP.NET 11gをインストールしてあるか、OTNからODP.NET 11gをインストールしてあること。

Windowsのプログラム・メニューから、Visual Studioを起動します。 Visual StudioのViewメニューから「Server Explorer」を選択します。

Server Explorerパネルが開きます。

「Data Connections」を右クリックして、メニューから「Add Connection」を選択します。

Add Connectionダイアログ・ボックスが開きます。

Add Connectionダイアログ・ボックスで、Data SourceがOracle Database Server (Oracle ODP.NET)に設定されていることを確認します。

注：Data SourceがOracle Database Server (Oracle ODP.NET)に設定されていない場合は、「Change」をクリックして、適切なデータソースとデータソース・プロバイダを選択します。

Change Data Sourceダイアログ・ボックスで、Data Sourceリストから「Oracle Database Server」を選択して、Data Providerドロップダウン・リストから「Oracle Data Provider for .NET」を選択します。 「OK」をクリックします。

Add Connectionダイアログ・ボックスで、Connection Detailsタブが選択されていることを確認します。 Data Sourceドロップダウン・リストから、使用しているOracleデータベース・インスタンスのSIDを選択します。

ユーザー名にSYS、パスワードにoracleと入力して、ドロップダウン・リストから「SYSDBA」ロールを選択します。 「OK」をクリックして接続します。

注：sysのパスワードはoracleではない場合があります。 データベース管理者にsysのパスワードを確認してください。

同様に、HRスキーマの接続を作成します。 Server Explorerで「Data Connections」を右クリックして、「Add Connection」を選択します。

Add Connectionダイアログ・ボックスでは、適切なデータソースとデータソース・プロバイダがすでに選択されています。

Connection Detailsタブで、ユーザー名にHR、パスワードにhrと入力します。 「OK」をクリックします。

注：HRスキーマのパスワードはhrではないことがあります。 データベース管理者にHRスキーマのパスワードを確認してください。

Server Explorerに2つの接続が表示されます。

Server Explorerで「SYS.ORCL」接続ノードを右クリックして、「Query Window」を選択します。 問合せウィンドウが開きます。

問合せウィンドウで、次のgrant文を入力します。

grant change notification to hr

「Execute Query」ボタンをクリックします。

問合せ出力ウィンドウに完了メッセージが表示されます。 Query Editorを閉じます。

Oracleに接続するために接続文字列の属性を変更する必要がある場合があります。 使用しているデータソースが、サービス名がorclまたはネット・サービス名がorclに設定されている単一のローカル・インスタンスの場合は、データソース接続文字列の属性を変更する必要はありません。

別のデータソース・エイリアスを使用する必要がある場合は、接続文字列変数のデータソース値"constr"を変更します。

注：HRスキーマに接続するので、ユーザーIDがHRに設定されており、パスワードの設定が正しいことを確認します。 例のコードでは、HRのパスワードは"hr"です。 使用しているHRスキーマのパスワードが"hr"ではない場合は、DBAに正しいパスワードを確認してください。

それぞれのコメントの下に次のコードを追加します。 コメントでは、コードの各行の機能を説明します。

cmd.AddRowid = true;
OracleDependency dep = new OracleDependency(cmd);
cmd.Notification.IsNotifiedOnce = false;
dep.OnChange += new OnChangeEventHandler(OnMyNotificaton);

Visual StudioのDebugメニューから、「Start Debugging」を選択します。 デモが実行されます。 ブレーク・ポイントにヒットしたら、[F5]を押し、HR.EMPLOYEES表の値を含むグリッドが表示されるまで実行を続けます。

注： このプログラムを初めて実行するときには、下のスクリーンショットに示されているような、Windowsファイアウォールからのメッセージが表示される場合があります。 「Unblock」をクリックして、変更通知がデータベース・サーバーからクライアントに送信されるようにします。

デモの実行は終了しないでください。

Server Explorerで横にある（+）プラス記号をクリックし、「HR.ORCL」を開きます。 次に、「Tables」ノードを開きます。

EMPLOYEES表を右クリックして、「Retrieve Data...」を選択し、そのデータをVisual Studioに表示します。

Microsoft Visual Studioダイアログ・ボックスに、100に設定されている最大行数よりも多くの行を取得するかどうかを尋ねるメッセージが表示された場合は、「Yes」をクリックします。

ウィンドウが開いて、従業員表のデータが表示されます。

Visual Studioで新たに開いたデータ・ウィンドウ（変更通知アプリケーション・グリッド内ではありません）で、SALARY値の1つを変更します。 「Save」をクリックすると、値がOracleデータベースにコミットされます。

数秒すると、変更通知アプリケーションによって、Notification Alertウィンドウが開き、結果セットが変更されたことが示されます。

注：このウィンドウが表示されない場合は、デスクトップ下部にあるタスクバーを確認してください。 タスクバーは非表示になっている場合があります。 （このウィンドウが表示される前にブレーク・ポイントにヒットした場合は、[F5]を押して続行します。）

「OK」をクリックします。 Oracle Database Change Notificationのデモを閉じます。

「Form1.cs」タブをクリックします。 ドロップダウン・ボックスで、「OnMyNotificaton(.. 」を選択します。

これで、OnMyNotificatonコールバック・ルーチンに入ります。

それぞれのコメントの下に次の一連のコードを追加します。 コメントでは、コードの各行の機能を説明します。

次の一連のコードは、変更された行だけを取得するために、基本の問合せにROWIDを追加します。

DataRow detailRow = args.Details.Rows[0];
string rowid = detailRow["Rowid"].ToString();
string sqlUpdate = sqlSelect + "where rowid = \'"+ rowid +"\'";


ほかにも更新された行が存在する場合は、次のコードをsqlUpdate文に追加します。

for (int i = 1; i < args.Details.Rows.Count; i++)
{
detailRow = args.Details.Rows[i];
rowid = detailRow["Rowid"].ToString();
sqlUpdate = sqlUpdate + " or rowid = \'"+ rowid +"\'";
}

次の一連のコードを追加して、データをリフレッシュします。

OracleConnection con2 = new OracleConnection(constr);
OracleCommand cmd2 = new OracleCommand(sqlUpdate,con2);
con2.Open();
OracleDataAdapter da2 = new OracleDataAdapter(cmd2);
da2.Fill(ds, tablename);

Buildメニューから、「Build Solution」を選択します。

エラーや警告がないことを確認します。

Debugメニューから、「Start Debugging」を選択します。 HR.EMPLOYEES表の値を含んでいる グリッドが表示されます。

これで、データベース内の複数の行を変更し、ODP.NETが変更された行だけを更新することを確認できます。

Solution Explorerで、「multiple_row_change.sql」をダブルクリックします。

multiple_row_change.sqlから次の行を選択します。 [CTRL]+[C]を押して、コードをコピーします。

update employees set salary=salary+10 where employee_id=100 or employee_id=101;
commit;
    

Server Explorerで、「HR.ORCL」を右クリックして、「Query Window」を選択します。 問合せウィンドウで、コードを貼り付け、両方の文が選択されていることを確認します。 「Execute Query」をクリックして、問合せを実行します。

Notification Alertが表示されます。 「OK」をクリックします。

アプリケーション・グリッドで、変更された行がリフレッシュされたことを確認します。

注：Oracleデータベースは、各行のROWIDで変更された行を識別します。 OracleNotificationEventArgsインスタンスは、ROWID情報をODP.NETに返します。表全体ではなく、変更された行だけが取得されます。 これにより、まだ有効なデータがリフレッシュされないようアプリケーションを保護します。

また、データベースのそれぞれの異なる変更に対して1つの通知が送られます。 2つの行が変更されたとしても、変更は1つの個別イベントとして発生します。 そのため、送信される通知は1つのみです。

Oracle Database Change Notificationデモ・ウィンドウを閉じます。

Visual Studioメニューから、「Debug」→「Start Debugging」を選択します。 Oracle Database Change Notificationデモ・ウィンドウに、従業員レコードが表示されます。

ここで、データベース内の複数の行を変更します。 ODP.NETは、変更された行だけを更新します。

まだ開いていない場合は、Solution Explorerから「multiple_row_change.sql」を開きます。

multiple_row_change.sqlから次の行を選択します。 [CTRL]+[C]を押して、コードをコピーします。

Update employees set salary=salary+10 where employee_id=200 or employee_id=201;
commit;

Server Explorerで、「HR.ORCL」を右クリックして、「Query Window」を選択します。 問合せウィンドウで、コードを貼り付け、両方の文が選択されていることを確認します。 「Execute Query」をクリックして、問合せを実行します。

実行しても、Notification Alertウィンドウは表示されません。

このupdate文はもとの問合せの対象外にある行に作用するので、データベース通知ハンドラは何のアクションも起こさないためです。