相関ローカルサービスのサンプル

[アーティクル]
09/17/2008

このサンプルでは、各種ローカルサービスの相関属性を使用して、ワークフローインスタンスに相関イベントを発生させる方法を示します。ローカルサービスインターフェイスで相関属性を使用する必要があるのは、ワークフローインスタンスが、ローカルサービスインターフェイス上の同じイベントの別のインスタンスをリッスンしている可能性がある場合です。

このサンプルでは、ワークフローはタスクを 2 つ作成し、これらのタスクが終了したことを示す同じローカルサービスイベントからの通知を待機します。このサンプルでは、外部コードによってワークフローに対するイベントが発生した場合、ローカルサービスインフラストラクチャは、発生するイベント内のデータ (関連付け値) に基づいて、ワークフローインスタンス内の適切な HandleExternalEventActivity アクティビティにイベントを配信します。

ExternalDataExchangeAttribute 属性は必須の属性で、ローカルサービスがワークフローとのデータ交換に参加することを示します。

CorrelationParameterAttribute 属性は、関連付け値が、既定ではインターフェイスに定義されているメソッドとイベント内の指定された名前のパラメータにあることを示します。サンプル内の次のコードは、CorrelationParameterAttribute 属性の使用方法を示しています。

[CorrelationParameter("taskId")]
public interface ITaskService

CorrelationInitializerAttribute 属性は、属性の適用されたメソッドが関係付け値を初期化するものであるため、検証を成功させるにはワークフローの先頭 (ローカルサービスインターフェイスに定義されている他の操作よりも前) に置く必要があることを示します。サンプル内の次のコードは、CorrelationInitializerAttribute 属性の使用方法を示しています。

[CorrelationInitializer]
void CreateTask( string taskId, string assignee, string text );

CorrelationAliasAttribute 属性は、関係付け値を CorrelationParameterAttribute 属性によって示される位置とは別の位置から取得する必要がある場合に、特定のメソッドまたはイベントについて CorrelationParameterAttribute 属性の設定をオーバーライドします。

それぞれのタスクが作成された後、タスクサービスはメッセージボックスを表示して、タスクが作成されたことをユーザーに通知します。[OK] ボタンがクリックされると、それぞれのタスク ID に対応するタスクを完了するためのイベントが発生します。これらは CreateTask アクティビティに設定されているのと同じプロパティなので、イベントは適切な TaskCompleted アクティビティに関連付けられます。

サンプルをビルドするには

[サンプルのダウンロード] をクリックしてサンプルをダウンロードします。

サンプルプロジェクトがローカルコンピュータのハードディスクにダウンロードされます。
[スタート] ボタンをクリックし、[すべてのプログラム] をポイントします。次に、[Microsoft Windows SDK] をポイントし、[CMD シェル] をクリックします。
サンプルのソースディレクトリに移動します。
コマンドプロンプトで、「MSBUILD <ソリューションファイル名>」と入力します。

サンプルを実行するには

SDK コマンドプロンプトウィンドウで、CorrelatedLocalService\bin\debug フォルダ (このサンプルの VB バージョンでは CorrelatedLocalService\bin フォルダ) にある .exe ファイルを実行します (このサンプルでは、メインフォルダの下にあります)。

次の方法で共有

相関ローカルサービスのサンプル

サンプルをビルドするには

サンプルを実行するには

関連項目

参照

その他の技術情報

その他のリソース

次の方法で共有

相関ローカル サービスのサンプル

サンプルをビルドするには

サンプルを実行するには

関連項目

参照

その他の技術情報

その他のリソース

相関ローカルサービスのサンプル