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 を入力し、[ 移動 ] を選択してサービスを検索します。 サービスでユーザー名とパスワードのセキュリティが実装されている場合は、ユーザー名とパスワードの入力を求められる場合があります。 独自のソリューションでサービスを選択することもできます。 [ 検出 ] ボタンを選択し、[ ソリューションのサービス] を選択します。

   注

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

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

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

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

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

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

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

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

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

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

2. [Microsoft WCF Web サービス参照プロバイダー] を選択します。

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

   

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

   注

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

   有効なサービス メタデータが見つかった前の 15 個の URL を格納する URI リストから URL を選択することもできます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. [Microsoft WCF Web サービス参照プロバイダー] を選択します。

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

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

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

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

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

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

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

サービス参照を更新する

WCF Data Services のエンティティ データ モデルが変更されることがあります。 この場合は、サービス参照を更新する必要があります。

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

サービス参照を削除する

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

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

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

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

  注

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

関連コンテンツ

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