Add Adapter Service Reference Visual Studio プラグインを使用して、SQL Server アーティファクトに対する選択した操作を対象とする WCF クライアント クラスを生成できます。 ServiceModel メタデータ ユーティリティ ツール (svcutil.exe) を使用して WCF クライアント クラスを生成することもできます。ただし、Add Adapter Service Reference プラグインは、標準の Microsoft Windows インターフェイスを介して ServiceModel メタデータ ユーティリティ ツールの機能を公開します。 また、svcutil.exe ツールでは使用できない参照および検索機能も提供され、SQL Server データベースに接続するときに選択したバインド プロパティに基づいて構成ファイルが生成されます。
アダプター サービス参照の追加プラグインを使用した WCF クライアント クラスの生成
アダプター サービス参照の追加プラグインを使用して WCF クライアント クラスを生成するには、次の手順を実行します。
Visual Studio ソリューション エクスプローラーで、プロジェクトを右クリックし、[ アダプター サービス参照の追加] をクリックします。
[ アダプター サービス参照の追加 ] ダイアログ ボックスが開いたら、「 SQL アダプターを使用した Visual Studio での SQL Server 操作のメタデータの取得 」の手順に従って SQL Server に接続し、操作を参照して検索します。 選択した操作の WCF クライアント クラスを作成するには、[コントラクトの種類の選択] ドロップダウン リストから [クライアント (送信操作)] が選択されていることを確認します。 (これが既定値です)。
対象とするすべての操作を選択したら、[OK] をクリックして WCF クライアント クラスを生成 します 。
アダプター サービス参照の追加プラグインは、プロジェクトに 2 つのファイルを追加します。
WCF クライアント コード ファイル。 このファイルには、選択した操作用に生成された WCF クライアント クラスとヘルパー コードが含まれています。 Add Adapter Service Reference Visual Studio プラグインを初めて実行すると、既定の名前 SQLAdapterBindingClient.csでこのファイルが生成されます。 もう一度実行すると、生成される次のファイルは SQLAdapterBindingClient1.cs呼び出されます。 生成する新しいファイルごとに、サフィックス番号が 1 ずつ増加します。 [OK] を選択してファイルを生成する前に、[アダプター サービス参照の追加] Visual Studio プラグインの [ファイル名のプレフィックス] フィールドに別のプレフィックスを入力して、既定のプレフィックス SQLBinding を変更することもできます。
App.config.このファイルには、アダプター サービス参照プラグインの追加の接続を構成したときに行った選択に基づくバインディング構成とクライアント エンドポイント構成が含まれています。
Von Bedeutung
Add Adapter Service Reference プラグインの使用中に、文字列型のバインド プロパティの値を指定せず、既定値が null の場合、そのバインド プロパティは app.config ファイルでは使用できません。 必要に応じて、バインド プロパティとその値を app.config ファイルに手動で追加する必要があります。
アダプター サービス リファレンスの追加プラグインを使用して、WCF サービス コントラクトを生成する
SQL Server データベースのポーリングやデータベースからの通知の受信などの受信操作の場合、SQL アダプターはクライアント アプリケーションで指定されたクエリを実行するか (ポーリングの場合)、またはクエリを SQL Server に登録します (通知の場合)。 どちらのシナリオでも、アダプターは SQL Server データベースから受信メッセージを使用側に送信します。 このような場合、使用するアプリケーションはサービスとして機能し、SQL アダプターはクライアントとして機能します。 そのため、アダプターから受信操作を受信できる WCF サービスを実装する必要があります。 これを行うには、アダプター サービス参照プラグインを使用して、受信操作用にアダプターによって表示されるサービス コントラクトを表す .NET インターフェイスを生成します。 この .NET インターフェイスは、WCF サービス コントラクトとも呼ばれます。 次に、このインターフェイスを実装して、受信操作の受信に使用できる WCF サービスを作成します。
アダプター サービス参照プラグインを使用して WCF サービス コントラクトを生成するには、次の手順を実行します。
受信操作用の WCF サービス コントラクトを生成するには
Visual Studio ソリューション エクスプローラーで、プロジェクトを右クリックし、[ アダプター サービス参照の追加] をクリックします。
[ アダプター サービス参照の追加 ] ダイアログ ボックスが開いたら、「 アダプター サービス参照の追加プラグインを使用した Visual Studio での SQL Server への接続 」の手順に従って、SQL Server データベースに接続します。
Von Bedeutung
TypedPolling 受信操作の WCF サービス コントラクトを生成する場合は、接続 URI と PollingStatement バインディング プロパティの一部として InboundID を指定する必要があります。
SQL Server データベースに接続したら、[コントラクトの種類の選択] ドロップダウン リストから [サービス (受信操作)] を選択します。
[ カテゴリの選択 ] ボックスで、ルート ノード (/) をクリックし、[ 利用可能なカテゴリと操作 ] ボックスから受信操作を選択し、[ 追加] をクリックします。
受信操作の WCF サービス コントラクトを生成するには、[OK] をクリック します。
アダプター サービス参照の追加プラグインは、プロジェクトに次の 3 つのファイルを追加します。
SqlAdapterBindingInterface.cs。 このファイルには、受信操作用に生成された WCF サービス コントラクト (インターフェイス) とヘルパー コードが含まれています。
SqlAdapterBindingService.cs。 このファイルには、SqlAdapterBindingInterface.csで定義されているインターフェイスを実装するクラスが含まれています。 受信操作によって返されるレコードを処理するビジネス ロジックを実装できます。
app.config.このファイルには、アダプター サービス参照プラグインのバインドと接続を構成したときに行った選択に基づくバインディング構成、エンドポイントの動作、およびサービス エンドポイントの構成が含まれています。
Von Bedeutung
Add Adapter Service Reference プラグインの使用中に、文字列型のバインド プロパティの値を指定せず、既定値が null の場合、そのバインド プロパティは app.config ファイルでは使用できません。 必要に応じて、バインド プロパティとその値を app.config ファイルに手動で追加する必要があります。
svcutil.exe を使用した WCF クライアント クラスの生成
svcutil.exe を使用して、アプリケーションの WCF クライアント クラスを生成できます。 SQL アダプターで使用するように svcutil.exe を構成する必要があります。
Svcutil.exe は、既定のファイル名が output.cs の出力ファイルに WCF クライアント クラス を生成します。 このファイルは、Visual Studio プロジェクトに手動で含める必要があります。 svcutil.exeの詳細については、「 ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)」を参照してください。