My.WebServices オブジェクト

現在のプロジェクトによって参照される各 XML Web サービスの 1 つのインスタンスを作成およびアクセスするためのプロパティを提供します。

注釈

My.WebServices オブジェクトは、現在のプロジェクトによって参照される各 Web サービスのインスタンスを提供します。 各インスタンスはオンデマンドでインスタンス化されます。 これらの Web サービスには、 My.WebServices オブジェクトのプロパティを使用してアクセスできます。 プロパティの名前は、プロパティがアクセスする Web サービスの名前と同じです。 SoapHttpClientProtocolから継承するすべてのクラスは Web サービスです。 Web サービスをプロジェクトに追加する方法については、「 アプリケーション Web サービスへのアクセス」を参照してください。

My.WebServices オブジェクトは、現在のプロジェクトに関連付けられている Web サービスのみを公開します。 参照される DLL で宣言されている Web サービスへのアクセスは提供されません。 DLL が提供する Web サービスにアクセスするには、Web サービスの修飾名を DllName 形式で使用する必要があります。WebServiceName。 詳細については、「 アプリケーション Web サービスへのアクセス」を参照してください。

オブジェクトとそのプロパティは、Web アプリケーションでは使用できません。

プロパティ

My.WebServices オブジェクトの各プロパティは、現在のプロジェクトによって参照されている Web サービスのインスタンスへのアクセスを提供します。 プロパティの名前は、プロパティがアクセスする Web サービスの名前と同じであり、プロパティの型は Web サービスの型と同じです。

My.WebServices オブジェクトのいずれかのプロパティに初めてアクセスすると、Web サービスの新しいインスタンスが作成され、格納されます。 そのプロパティの後続のアクセスは、Web サービスのそのインスタンスを返します。

Web サービスのプロパティに Nothing を割り当てることで、Web サービスを破棄できます。 プロパティ セッターは、格納されている値に Nothing を割り当てます。 プロパティに Nothing 以外の値を割り当てると、セッターは ArgumentException 例外をスローします。

Is演算子または IsNot 演算子を使用して、My.WebServices オブジェクトのプロパティが Web サービスのインスタンスを格納するかどうかをテストできます。 これらの演算子を使用して、プロパティの値が Nothingされているかどうかを確認できます。

例

この例では、TemperatureConverter XML Web サービスのFahrenheitToCelsius メソッドを呼び出し、結果を返します。

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

    Return My.WebServices.TemperatureConverter.FahrenheitToCelsius(dFahrenheit)
End Function

この例を機能させるには、プロジェクトが Converter という名前の Web サービスを参照し、その Web サービスが ConvertTemperature メソッドを公開する必要があります。 詳細については、「 アプリケーション Web サービスへのアクセス」を参照してください。

このコードは、Web アプリケーション プロジェクトでは機能しません。

要求事項

プロジェクトの種類別の可用性

こちらも参照ください

• SoapHttpClientProtocol
• ArgumentException
• アプリケーション Web サービスへのアクセス