WCF データ サービス参照を追加、更新、または削除する
NET Framework プロジェクトでは、サービス参照 によりプロジェクトが 1 つまたは複数の WCF Data Services にアクセスできるようになります。 サービス参照の追加 ダイアログ ボックスを使って、現在のソリューション内、ローカル、ローカルエリアネットワーク上、またはインターネット上で WCF Data Services を検索します。
.NET Core プロジェクトでは、ソリューション エクスプローラーの [接続済みサービス] ノードを使用して Microsoft WCF Web サービス リファレンス プロバイダーにアクセスできます。これにより、Windows Communication Foundation (WCF) データ サービス参照を管理できます。
Note
この記事で紹介する Visual Studio ユーザー インターフェイス要素の一部は、お使いのコンピューターでは名前や場所が異なる場合があります。 Visual Studio のエディションや環境設定がお使いのものと異なる場合があります。 詳細については、「Visual Studio IDE のカスタマイズ」を参照してください。
前提条件
WCF ツールは .NET ワークロードと一緒にはインストールされません。Visual Studio インストーラーを使用して、インストールを変更してください。 インストーラーで、[個別のコンポーネント] の下の [Windows Communication Foundation] を選択します。 Visual Studio の変更に関するページを参照してください。
WCF サービス参照を追加する
外部サービスへの参照を追加するには (.NET Framework プロジェクト)
ソリューション エクスプローラーで、サービスを追加するプロジェクトの名前を右クリックし、[サービス参照の追加] を選択します。
[サービス参照の追加] ダイアログ ボックスが表示されます。
[アドレス] ボックスにサービスの URL を入力し、[Go] を選択してサービスを検索します。 サービスでユーザー名とパスワードのセキュリティを実装する場合は、ユーザー名とパスワードの入力を求められることがあります。 また、独自のソリューションでサービスを選択することもできます。 [検出] ボタンをクリックし、[ソリューションのサービス] を選択します。
Note
信頼できるソースのサービスのみを参照してください。 信頼できないソースの参照を追加すると、セキュリティが損なわれる可能性があります。
アドレス一覧から URL を選択することもできます。ここには、有効なサービス メタデータが見つかった以前の 15 個の URL が格納されます。
検索が実行されると、進行状況バーが表示されます。 [停止] をクリックすると、いつでも検索を停止できます。
サービスの一覧で、使用するサービスのノードを展開し、エンティティ セットを選択します。
名前空間 ボックスに、参照で使用する名前空間を入力します。
OK をクリックして、プロジェクトに参照を追加します。
サービス クライアント (プロキシ) が生成され、サービスについて説明するメタデータが app.config ファイルに追加されます。
外部サービスへの参照を追加するには (.NET 5 以降を含む.NET Core プロジェクト)
ソリューション エクスプローラーで、[接続済みサービス] ノードをダブルクリックまたはタップします。
[サービスの構成] タブが開きます。
[Microsoft WCF Web サービス リファレンス プロバイダー] を選択します。
[WCF Web サービス参照の構成] ダイアログ ボックスが表示されます。
![[WCF Web サービスプロバイダー] ダイアログ ボックスのスクリーンショット](media/vs-2019/configure-wcf-web-service-reference-dialog.png?view=vs-2022)
[URI] ボックスにサービスの URL を入力し、[Go] を選択してサービスを検索します。 サービスでユーザー名とパスワードのセキュリティを実装する場合は、ユーザー名とパスワードの入力を求められることがあります。
Note
信頼できるソースのサービスのみを参照してください。 信頼できないソースの参照を追加すると、セキュリティが損なわれる可能性があります。
URI 一覧から URL を選択することもできます。ここには、有効なサービス メタデータが見つかった以前の 15 個の URL が格納されます。
検索が実行されると、進行状況バーが表示されます。 [停止] をクリックすると、いつでも検索を停止できます。
サービスの一覧で、使用するサービスのノードを展開し、エンティティ セットを選択します。
名前空間 ボックスに、参照で使用する名前空間を入力します。
[完了] をクリックして、プロジェクトに参照を追加します。
サービス クライアント (プロキシ) が生成され、サービスについて説明するメタデータが app.config ファイルに追加されます。
現在のソリューションのサービスへの参照を追加するには (.NET Framework プロジェクト)
ソリューション エクスプローラーで、サービスを追加するプロジェクトの名前を右クリックし、[サービス参照の追加] を選択します。
[サービス参照の追加] ダイアログ ボックスが表示されます。
[検出] をクリックします。
現在のソリューション内のすべてのサービス (WCF Data Services と Data Services の両方) がサービスの一覧に追加されます。
サービスの一覧で、使用するサービスのノードを展開し、エンティティ セットを選択します。
名前空間 ボックスに、参照で使用する名前空間を入力します。
OK をクリックして、プロジェクトに参照を追加します。
サービス クライアント (プロキシ) が生成され、サービスについて説明するメタデータが app.config ファイルに追加されます。
現在のソリューションのサービスへの参照を追加するには (NET Core プロジェクト)
ソリューション エクスプローラーで、[接続済みサービス] ノードをダブルクリックまたはタップします。
[サービスの構成] タブが開きます。
[Microsoft WCF Web サービス リファレンス プロバイダー] を選択します。
[WCF Web サービス参照の構成] ダイアログ ボックスが表示されます。
[検出] をクリックします。
現在のソリューション内のすべてのサービス (WCF Data Services と Data Services の両方) がサービスの一覧に追加されます。
サービスの一覧で、使用するサービスのノードを展開し、エンティティ セットを選択します。
名前空間 ボックスに、参照で使用する名前空間を入力します。
[完了] をクリックして、プロジェクトに参照を追加します。
サービス クライアント (プロキシ) が生成され、サービスについて説明するメタデータが app.config ファイルに追加されます。
サービス参照の更新
WCF Data Services の Entity Data Model は変更される場合があります。 この場合は、サービス参照を更新する必要があります。
サービス参照を更新するには
ソリューション エクスプローラーで、サービス参照を右クリックし、[サービス参照の更新] を選択します。
参照が元の場所から更新されている間、進行状況を示すダイアログ ボックスが表示され、メタデータの変更を反映するためにサービス クライアントが再生成されます。
.NET Core プロジェクトの場合は、dotnet-svcutil ツールを使用します。 インストールと手順については、dotnet-svcutil に関するページを参照してください。
.NET Framework プロジェクトの場合。
ソリューション エクスプローラーで、[接続済みサービス] ノードを展開し、サービス参照を右クリックしてから、[サービス参照の更新] を選択します。
参照が元の場所から更新されている間、進行状況を示すダイアログ ボックスが表示され、メタデータの変更を反映するためにサービス クライアントが再生成されます。
サービス参照の削除
サービス参照が使用されなくなった場合は、ソリューションから削除できます。
サービス参照を削除するには
ソリューション エクスプローラーで、サービス参照を右クリックしてから、[削除] を選択します。
サービス クライアントがソリューションから削除され、サービスを説明するメタデータが app.config ファイルから削除されます。
Note
サービス参照を参照するコードは、手動で削除する必要があります。