方法 : リモート Web 参照を追加および削除する

[アーティクル]
10/22/2014

更新 : 2007 年 11 月

Web 参照を使用すると、プロジェクトで 1 つ以上の XML Web サービスを使用できます。[Web 参照の追加] ダイアログボックスを使用して、ローカルに、ローカルエリアネットワークで、またはインターネット上で Web サービスを検索できます。

現在のプロジェクトに Web 参照を追加したら、その Web サービスで公開されている任意のメソッドを呼び出すことができます。詳細については、「方法 : Web サービスを呼び出す」を参照してください。

Web サービスクラスを作成する方法の詳細については、「チュートリアル : ASP.NET を使用する基本的な XML Web サービスの構築」を参照してください。

プロジェクトに Web 参照を追加するには

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

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

[URL] ボックスに、使用する Web サービスの URL を入力します。URL がわからない場合、ブラウザペイン内のリンクを使用して、目的の Web サービスを探します。

メモ :
ファイアウォールの内部にあるコンピュータで Web アプリケーションを開発しているとき、ファイアウォールの外側にある Web サービスをアプリケーションで使用する場合は、ローカルネットワークにあるプロキシサーバーのアドレスとポートを URL に含める必要があります。プロキシサーバーのアドレスとポートについては、ネットワーク管理者に問い合わせてください。詳細については、Visual Studio 2005 SDK の「このコンピュータ上で、Web 探索に対するプロキシ設定が正しく構成されていません。」を参照してください。

ファイアウォールの内部にあるコンピュータで Web アプリケーションを開発しているとき、ファイアウォールの外側にある Web サービスをアプリケーションで使用する場合は、ローカルネットワークにあるプロキシサーバーのアドレスとポートを URL に含める必要があります。プロキシサーバーのアドレスとポートについては、ネットワーク管理者に問い合わせてください。詳細については、Visual Studio 2005 SDK の「このコンピュータ上で、Web 探索に対するプロキシ設定が正しく構成されていません。」を参照してください。

[この URL で見つかった Web サービス] ボックスで、使用する Web サービスを選択します。

Web サービスをプロジェクトで使用できるかどうか、および提供されている外部コードが信頼できるかどうかを確認します。

セキュリティに関するメモ :
Web 参照を含むプロジェクトを編集するために開くと、使用する Web サービスのローカルプロキシファイルが、信頼されているユーザー (つまりユーザー自身) によって起動された Devenv.exe のプロセス内で実行されます。プロジェクトやコンポーネントを統合開発環境 (IDE: Integrated Development Environment) で開くと、ローカルコンピュータでコードが実行される可能性があります。詳細については、「Web アプリケーションのセキュリティ上の脅威の概要」および「コードアクセスセキュリティ」を参照してください。

Web 参照を含むプロジェクトを編集するために開くと、使用する Web サービスのローカルプロキシファイルが、信頼されているユーザー (つまりユーザー自身) によって起動された Devenv.exe のプロセス内で実行されます。プロジェクトやコンポーネントを統合開発環境 (IDE: Integrated Development Environment) で開くと、ローカルコンピュータでコードが実行される可能性があります。詳細については、「Web アプリケーションのセキュリティ上の脅威の概要」および「コードアクセスセキュリティ」を参照してください。

[Web 参照名] フィールドに Web 参照の名前を入力します。後でこの名前をコード内で使用して、選択した Web サービスにプログラムからアクセスできるようにします。

メモ :
既定では、Web 参照にはサーバー名に対応する名前空間が割り当てられます。この値を変更して、カスタムの名前空間名を入力できます。許容される名前空間名には、いくつかの制限事項があります。Web 参照名で使用できない文字の詳細については、「[Web 参照の追加] ダイアログボックス」を参照してください。Visual Web Developer は、入れ子構造のフォルダ階層を構築することにより、Web 参照名に基づいて名前空間を作成します。最下位のフォルダ内には、Web サービスを参照する .wsdl ファイルのほか、Web サービスの場所情報が記述されている探索ファイル (.disco および .discomap) などの補助ファイルが作成されます。

既定では、Web 参照にはサーバー名に対応する名前空間が割り当てられます。この値を変更して、カスタムの名前空間名を入力できます。許容される名前空間名には、いくつかの制限事項があります。Web 参照名で使用できない文字の詳細については、「[Web 参照の追加] ダイアログボックス」を参照してください。Visual Web Developer は、入れ子構造のフォルダ階層を構築することにより、Web 参照名に基づいて名前空間を作成します。最下位のフォルダ内には、Web サービスを参照する .wsdl ファイルのほか、Web サービスの場所情報が記述されている探索ファイル (.disco および .discomap) などの補助ファイルが作成されます。