手順 1: WCF LOB アダプター開発ウィザードを使用してエコーアダプタープロジェクトを作成する

2025-06-05

手順 1/9

完了までの時間: 15 分

この手順では、Visual Studio とアダプター開発ウィザードを使用してプロジェクトを作成します。アダプター開発ウィザードでは、システムのカスタムアダプターの開発に関連する手順について説明します。メッセージ交換パターン、メタデータ機能、アダプターのプロパティ、接続プロパティに関する情報を収集します。ウィザードが正常に完了すると、一連のファイルが生成されます。

[前提条件]

「チュートリアルを開始する前に」で説明されている知識を持ち、WCF LOB アダプター SDK を使用してアダプター開発用のコンピューターを正常に設定している必要があります。

Visual Studio で WCF LOB アダプタープラグインを選択する

Visual Studio を起動し、[ ファイル ] メニューの [ 新規作成] をポイントし、[ プロジェクト] をクリックします。

[新しいプロジェクト ] ダイアログボックスで、次の操作を行います。

これを使用する	目的
プロジェクトの種類	[ Visual C#] をクリックします。
テンプレート	[ WCF LOB アダプター] をクリックします。
名前	EchoAdapter と入力します。
場所	「C:\Tutorials」と入力します。
ソリューションのディレクトリを作成する	ソリューションファイルのディレクトリを作成するには、このチェックボックスをオンにします。
ソリューション名	EchoAdapterSampleV2 と入力します。

次の図は、[ 新しいプロジェクト ] ダイアログボックスを示しています。

[新しいプロジェクト] ダイアログボックスを示すスクリーンショット。

OK をクリックします。
[ようこそ] ページで [次へ] をクリックします。次の図は 、[ようこそ ] ページを示しています。
[次へ] をクリックします。

スキームと名前空間の情報を入力する

[ スキーム]、[名前空間]、[URI 情報 ] ページで、次の操作を行います。

これを使用する	目的
計画	echov2 と入力します。
プロジェクトの名前空間	「Microsoft.Adapters.Samples.EchoV2」と入力します。

次の図は 、[スキーム]、[名前空間]、[URI 情報 ] ページを示しています。

[スキーム]、[名前空間]、[URI 情報] ページを示すスクリーンショット。

[次へ] をクリックします。

データフローとメタデータ機能を入力する

[ データフロー と メタデータ機能] ページで、次の操作を行います。

メッセージ交換パターン

これを使用する	目的
同期送信	チェックボックスをオンにします。
同期受信	チェックボックスをオンにします。

メタデータ機能

これを使用する	目的
検索	チェックボックスをオンにします。
ブラウズ	チェックボックスをオンにします。
検索	チェックボックスをオンにします。

注

このコンテキストのデータフローは、概念トピックで使用される用語であるメッセージ交換パターンと同じ意味です。

次の図は、[ データフロー と メタデータ機能] ページを示しています。

[データフローとメタデータ機能] ページを示すスクリーンショット。

[次へ] をクリックします。

アダプターのプロパティを入力する

[ アダプターのプロパティ ] ページで、次の操作を行います。

Count というプロパティを追加 します。この数は、エコーアダプターのすべての操作で使用されます。各操作は、入力値の Count 回数を返します。

これを使用する	目的
プロパティ名	入力数。
データ型	System.Int32 を選択します。
既定値	「 5」と入力します。
追加	クリックして、新しいアダプタープロパティを追加します。

EnableConnectionPooling というプロパティを追加します。このフラグは、ランタイム接続プールを有効または無効にするために WCF LOB アダプター SDK によって使用されます。

これを使用する	目的
プロパティ名	「EnableConnectionPooling」と入力します。
データ型	System.Boolean を選択します。
既定値	「true」と入力します。
追加	クリックして、新しいアダプタープロパティを追加します。

InboundFileFilter というプロパティを追加します。このプロパティは、この拡張子のファイルを監視するために FileSystemWatcher によって使用されます。このプロパティは、受信シナリオにのみ適用されます。

これを使用する	目的
プロパティ名	「InboundFileFilter」と入力します。
データ型	System.String を選択します。
既定値	*.txtと入力します。
追加	クリックして、新しいアダプタープロパティを追加します。

InboundFileSystemWatcherFolder というプロパティを追加します。このプロパティは、FileSystemWatcher がアダプターに通知を送信するためにファイルを削除するフォルダーを設定するために使用されます。このプロパティは、受信シナリオにのみ適用されます。

これを使用する	目的
プロパティ名	「InboundFileSystemWatcherFolder」と入力します。
データ型	System.String を選択します。
既定値	C:\\inbound\\watcher を入力します。
追加	クリックして、新しいアダプタープロパティを追加します。

次の図は、[ アダプターのプロパティ] ページを示しています。

[アダプターのプロパティ] ページを示すスクリーンショット。

[次へ] をクリックします。

接続プロパティを入力する

[ 接続のプロパティ ] ページで、次の操作を行います。

Application というプロパティを追加します。このプロパティは説明のみを目的としています。エコーアダプターには LOB システムは含まれません。

これを使用する	目的
プロパティ名	「アプリケーション」と入力します。
データ型	System.String を選択します。
既定値	lobapplication と入力します。
追加	クリックして、新しいアダプタープロパティを追加します。

EnableAuthentication というプロパティを追加します。 true の場合、アダプターはクライアント資格情報内のユーザー名フィールドに値があることを期待します。

これを使用する	目的
プロパティ名	「EnableAuthentication」と入力します。
データ型	System.Boolean を選択します。
既定値	false と入力します。
追加	クリックして、新しいアダプタープロパティを追加します。

HostName というプロパティを追加します。このプロパティは、プロパティ Application に似た説明のみを目的としています。

これを使用する	目的
プロパティ名	「ホスト名」と入力します。
データ型	System.String を選択します。
既定値	lobhostname と入力します。
追加	クリックして、新しいアダプタープロパティを追加します。

EchoInUpperCase というプロパティを追加します。このプロパティは、一部の操作でエコーされた文字列を大文字に変換するか、元の形式のままにするかを制御します。

これを使用する	目的
プロパティ名	EchoInUpperCase と入力します。
データ型	System.Boolean を選択します。
既定値	False と入力します。
追加	クリックして、新しいアダプタープロパティを追加します。

[次へ] をクリックします。

ウィザードを終了する

[ 概要 ] ページで、[ 完了] をクリックします。次の図は、EchoAdapter プロジェクトを含むソリューションエクスプローラーを示しています。

プロジェクトには同じファイルが含まれている必要があります。そうでない場合は、Visual Studio を終了し、 EchoAdapterSampleV2 フォルダーを削除してから、チュートリアルのこの手順を再開します。
Visual Studio の [ ファイル ] メニューの [ すべて保存] をクリックします。

注

作業を保存しました。この時点で Visual Studio を安全に閉じるか、次の手順「手順 2: アダプターと接続のプロパティを分類する」に進むことができます。

私は何をしましたか?

この手順では、Visual Studio とアダプター開発ウィザードを使用してエコーアダプターソリューションを作成しました。次の表に、一連のファイルと各ファイルの目的を示します。

ファイル名	説明
EchoAdapter.cs	これは、 `Microsoft.ServiceModel.Channels.Common.Adapter`から継承するメインアダプタークラスです。エコーアダプターに変更は必要ありません。
EchoAdapterBinding.cs	これは、アダプターのバインドを作成するときに使用されるクラスです。エコーアダプターに変更は必要ありません。
EchoAdapterBindingCollectionElement.cs	これは、 `System.ServiceModel.Configuration.StandardBindingCollectionElement`を実装する Binding Collection Element クラスです。エコーアダプターに変更は必要ありません。
EchoAdapterBindingElement.cs	これにより、構成要素の基本クラスが提供されます。エコーアダプターのアダプターと接続プロパティを分類するには、手順 2: アダプターと接続のプロパティを分類する手順に従います。
EchoAdapterBindingElementExtensionElement.cs	このクラスは、ユーザー定義 WCF カスタムバインド内で使用できるように、アダプターをバインド要素として表すために提供されます。エコーアダプターのアダプターと接続プロパティを分類するには、手順 2: アダプターと接続のプロパティを分類する手順に従います。
EchoAdapterHandlerBase.cs	これは、基底クラスによって公開される共通のプロパティ/ヘルパー関数を格納するために使用されるハンドラーの基本クラスです。エコーアダプターのアダプターと接続プロパティを分類するには、手順 2: アダプターと接続のプロパティを分類する手順に従います。
EchoAdapterConnection.cs	これにより、ターゲットシステムへの接続が定義されます。エコーアダプターのターゲットシステムへの接続をサポートするには、「手順 3: エコーアダプターの接続を実装する」に従います。
EchoAdapterConnectionFactory.cs	これにより、ターゲットシステムの接続ファクトリが定義されます。エコーアダプターのターゲットシステムへの接続をサポートするには、「手順 3: エコーアダプターの接続を実装する」に従います。
EchoAdapterConnectionUri.cs	これは、アダプター接続 URI を表すクラスです。エコーアダプターのターゲットシステムへの接続をサポートするには、手順 3: エコーアダプターの接続を実装する) に従います。
EchoAdapterMetadataBrowseHandler.cs	このクラスは、ターゲットシステムからのメタデータの接続ベースの参照を実行するときに使用されます。エコーアダプターのメタデータ参照機能をサポートするには、手順 4: エコーアダプターのメタデータ参照ハンドラーを実装する手順に従います。
EchoAdapterMetadataSearchHandler.cs	このクラスは、ターゲットシステムからのメタデータの接続ベースの検索を実行するために使用されます。エコーアダプターのメタデータ検索機能をサポートするには、「手順 5: エコーアダプターのメタデータ検索ハンドラーを実装する」に従います。
EchoAdapterMetadataResolve.cs	このクラスは、ターゲットシステムからのメタデータの接続ベースの取得を実行するために使用されます。エコーアダプターのメタデータ解決機能をサポートするには、「手順 6: Echo アダプターのメタデータ解決ハンドラーを実装する」に従います。
EchoAdapterOutboundHandler.cs	このクラスは、ターゲットシステムにデータを送信するために使用されます。エコーアダプターの送信メッセージ交換をサポートするには、「手順 7: エコーアダプターの同期送信ハンドラーを実装する」に従います。
EchoAdapterInboundHandler.cs	このクラスは、データをリッスンまたはポーリングするためのインターフェイスを実装します。エコーアダプターの受信メッセージ交換をサポートするには、「手順 8: エコーアダプターの同期受信ハンドラーを実装する」に従います。
EchoAdapterTrace.cs	このクラスは、デバッグとトラブルシューティングのためにアダプタートレースを実装します。

次のステップ

UI 論理グループ化のアダプターと接続プロパティを分類し、接続、メタデータの参照、検索、解決機能、および送信メッセージと受信メッセージ交換を実装します。最後に、エコーアダプターをビルドして展開します。

こちらもご覧ください

手順 2: アダプターと接続のプロパティを分類する
 チュートリアル 1: エコーアダプターを開発する

次の方法で共有

手順 1: WCF LOB アダプター開発ウィザードを使用してエコー アダプター プロジェクトを作成する