WCF Web サービス参照プロバイダーツールを使用する

2025-06-17

長年にわたり、多くの Visual Studio 開発者は、.NET Framework プロジェクトが Web サービスにアクセスする必要があるときにサービス 参照の追加 ツールが提供する生産性を享受してきました。

WCF Web サービス参照ツールは、.NET 5 以降、.NET Core、または ASP.NET Core プロジェクトを Web サービスに接続できる Visual Studio 接続済みサービス拡張機能です。これは、.NET Framework プロジェクト専用の サービス参照の追加 機能と同様のエクスペリエンスを提供します。 WCF Web サービス参照ツールは、現在のソリューション内の Web サービス、ネットワーク上の場所、または WSDL ファイルからメタデータを取得し、.NET アプリが Web サービスへのアクセスに使用できる Windows Communication Foundation (WCF) クライアントプロキシコードを含むソースファイルを生成します。

Von Bedeutung

信頼できるソースからのみサービスを参照する必要があります。信頼されていないソースからの参照を追加すると、セキュリティが損なわれる可能性があります。

[前提条件]

Visual Studio 2017 バージョン 15.5 以降のバージョン

この記事のスクリーンショットは、Visual Studio 2022 のスクリーンショットです。

拡張機能の使用方法

注

WCF Web サービス参照ツールは、C# .NET Core および .NET Standard プロジェクト (ASP.NET Core Web アプリを含む) にのみ適用できます。

この記事では 、ASP.NET Core Web アプリケーション プロジェクトテンプレートを例として使用して、WCF サービス参照をプロジェクトに追加する手順について説明します。

ソリューションエクスプローラーで、プロジェクトの [接続済みサービス ] ノードをダブルクリックします。 (.NET Core または .NET Standard プロジェクトの場合は、プロジェクトを右クリックし、[追加] を選択します>接続済みサービス)。)

次の図に示すように、[ 接続済みサービス ] ページが表示されます。
[ 接続済みサービス ] ページで、[ サービス参照の追加] を選択します。

[ サービス参照の追加] ページが開きます。
[WCF Web サービス] を選択し、[次へ] を選択します。

これにより 、新しい WCF Web サービスサービス参照の追加 ウィザードが表示されます。
サービスを選択します。

ある。いくつかのサービス検索オプションを使用できます。
- 現在のソリューションで定義されているサービスを検索するには、[ 検出 ] ボタンをクリックします。
- 指定したアドレスでホストされているサービスを検索するには、[ アドレス] ボックス にサービス URL を入力し、[ 移動 ] ボタンをクリックします。
- Web サービスのメタデータ情報を含む WSDL ファイルを選択するには、[ 参照 ] ボタンをクリックします。
b。 [サービス] ボックスの検索結果の一覧から サービス を選択します。必要に応じて、生成されたコードの名前空間を対応する [名前空間] テキストボックスに入力します。

c. [ 次へ ] ボタンをクリックして、データ型オプションまたはクライアントオプションを指定します。または、[ 完了 ] ボタンをクリックして既定のオプションを使用します。
[データ型のオプション] ページでは、生成されたサービス参照の構成設定を絞り込むことができます。

注

[ 参照アセンブリの型を再利用 する] チェックボックスオプションは、サービス参照コードの生成に必要なデータ型がプロジェクトの参照アセンブリのいずれかで定義されている場合に便利です。コンパイル時の型の競合や実行時の問題を回避するために、これらの既存のデータ型を再利用することが重要です。

プロジェクトの依存関係の数やその他のシステムパフォーマンス要因によっては、型情報の読み込み中に遅延が発生する可能性があります。 [参照アセンブリの型を再利用する] チェックボックスがオフでない限り、読み込み中に [完了] ボタンは無効になります。
完了したら、[ 完了] をクリックします。