WCF データ サービス参照を追加、更新、または削除する

NET Framework プロジェクトでは、サービス参照 によりプロジェクトが 1 つまたは複数の WCF Data Services にアクセスできるようになります。 サービス参照の追加 ダイアログ ボックスを使って、現在のソリューション内、ローカル、ローカルエリアネットワーク上、またはインターネット上で WCF Data Services を検索します。

.NET Core プロジェクトでは、ソリューション エクスプローラーの [接続済みサービス] ノードを使用して Microsoft WCF Web サービス リファレンス プロバイダーにアクセスできます。これにより、Windows Communication Foundation (WCF) データ サービス参照を管理できます。

前提条件

WCF ツールは .NET ワークロードと一緒にはインストールされません。Visual Studio インストーラーを使用して、インストールを変更してください。 インストーラーで、[個別のコンポーネント] の下の [Windows Communication Foundation] を選択します。 Visual Studio の変更に関するページを参照してください。

WCF サービス参照を追加する

外部サービスへの参照を追加するには (.NET Framework プロジェクト)

1. ソリューション エクスプローラーで、サービスを追加するプロジェクトの名前を右クリックし、[サービス参照の追加] をクリックします。

   [サービス参照の追加] ダイアログ ボックスが表示されます。

2. [アドレス] ボックスにサービスの URL を入力し、[検索] をクリックしてサービスを検索します。 サービスでユーザー名とパスワードのセキュリティを実装する場合は、ユーザー名とパスワードの入力を求められることがあります。 また、独自のソリューションでサービスを選択することもできます。 [検出] ボタンをクリックし、[ソリューションのサービス] を選択します。

   Note

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

   アドレス一覧から URL を選択することもできます。ここには、有効なサービス メタデータが見つかった以前の 15 個の URL が格納されます。

   検索が実行されると、進行状況バーが表示されます。 [停止] をクリックすると、いつでも検索を停止できます。

3. サービスの一覧で、使用するサービスのノードを展開し、エンティティ セットを選択します。

4. 名前空間 ボックスに、参照で使用する名前空間を入力します。

5. OK をクリックして、プロジェクトに参照を追加します。

   サービス クライアント (プロキシ) が生成され、サービスについて説明するメタデータが app.config ファイルに追加されます。

外部サービスへの参照を追加するには (.NET 5 以降を含む.NET Core プロジェクト)

1. ソリューション エクスプローラーで、[接続済みサービス] ノードをダブルクリックまたはタップします。

   [サービスの構成] タブが開きます。

2. [Microsoft WCF Web サービス リファレンス プロバイダー] を選択します。

   [WCF Web サービス参照の構成] ダイアログ ボックスが表示されます。

   

3. [URI] ボックスにサービスの URL を入力し、 [検索] をクリックしてサービスを検索します。 サービスでユーザー名とパスワードのセキュリティを実装する場合は、ユーザー名とパスワードの入力を求められることがあります。

   Note

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

   URI 一覧から URL を選択することもできます。ここには、有効なサービス メタデータが見つかった以前の 15 個の URL が格納されます。

   検索が実行されると、進行状況バーが表示されます。 [停止] をクリックすると、いつでも検索を停止できます。

4. サービスの一覧で、使用するサービスのノードを展開し、エンティティ セットを選択します。

5. 名前空間 ボックスに、参照で使用する名前空間を入力します。

6. [完了] をクリックして、プロジェクトに参照を追加します。

   サービス クライアント (プロキシ) が生成され、サービスについて説明するメタデータが app.config ファイルに追加されます。

現在のソリューションのサービスへの参照を追加するには (.NET Framework プロジェクト)

1. ソリューション エクスプローラーで、サービスを追加するプロジェクトの名前を右クリックし、[サービス参照の追加] をクリックします。

   [サービス参照の追加] ダイアログ ボックスが表示されます。

2. [検出] をクリックします。

   現在のソリューション内のすべてのサービス (WCF Data Services と Data Services の両方) がサービスの一覧に追加されます。

3. サービスの一覧で、使用するサービスのノードを展開し、エンティティ セットを選択します。

4. 名前空間 ボックスに、参照で使用する名前空間を入力します。

5. OK をクリックして、プロジェクトに参照を追加します。

   サービス クライアント (プロキシ) が生成され、サービスについて説明するメタデータが app.config ファイルに追加されます。

現在のソリューションのサービスへの参照を追加するには (NET Core プロジェクト)

1. ソリューション エクスプローラーで、[接続済みサービス] ノードをダブルクリックまたはタップします。

   [サービスの構成] タブが開きます。

2. [Microsoft WCF Web サービス リファレンス プロバイダー] を選択します。

   [WCF Web サービス参照の構成] ダイアログ ボックスが表示されます。

3. [検出] をクリックします。

   現在のソリューション内のすべてのサービス (WCF Data Services と Data Services の両方) がサービスの一覧に追加されます。

4. サービスの一覧で、使用するサービスのノードを展開し、エンティティ セットを選択します。

5. 名前空間 ボックスに、参照で使用する名前空間を入力します。

6. [完了] をクリックして、プロジェクトに参照を追加します。

   サービス クライアント (プロキシ) が生成され、サービスについて説明するメタデータが app.config ファイルに追加されます。

サービス参照の更新

WCF Data Services の Entity Data Model は変更される場合があります。 この場合は、サービス参照を更新する必要があります。

サービス参照を更新するには

サービス参照の削除

サービス参照が使用されなくなった場合は、ソリューションから削除できます。

サービス参照を削除するには

• ソリューション エクスプローラーで、サービス参照を右クリックし、[削除] をクリックします。

  サービス クライアントがソリューションから削除され、サービスを説明するメタデータが app.config ファイルから削除されます。

  Note

  サービス参照を参照するコードは、手動で削除する必要があります。

関連するコンテンツ

• Visual Studio での Windows Communication Foundation サービスと WCF データ サービス