My.WebServices 개체

  • 아티클

현재 프로젝트에서 참조하는 각 XML 웹 서비스의 단일 인스턴스를 만들고 액세스하기 위한 속성을 제공합니다.

설명

My.WebServices 개체는 현재 프로젝트에서 참조하는 각 웹 서비스의 인스턴스를 제공합니다. 필요에 따라 각 인스턴스가 인스턴스화됩니다. My.WebServices 개체의 속성을 통해 이러한 웹 서비스에 액세스할 수 있습니다. 속성 이름은 속성이 액세스하는 웹 서비스의 이름과 같습니다. SoapHttpClientProtocol에서 상속되는 모든 클래스는 웹 서비스입니다. 프로젝트에 웹 서비스를 추가하는 방법에 대한 자세한 내용은 애플리케이션 웹 서비스 액세스를 참조하세요.

My.WebServices 개체는 현재 프로젝트와 연결된 웹 서비스만 노출합니다. 참조된 DLL에 선언된 웹 서비스에 대한 액세스는 제공하지 않습니다. DLL에서 제공하는 웹 서비스에 액세스하려면 DllName.WebServiceName 형식으로 웹 서비스의 정규화된 이름을 사용해야 합니다. 자세한 내용은 애플리케이션 웹 서비스 액세스를 참조하세요.

개체 및 해당 속성은 웹 애플리케이션에서 사용할 수 없습니다.

속성

My.WebServices 개체의 각 속성은 현재 프로젝트에서 참조하는 웹 서비스의 인스턴스에 대한 액세스를 제공합니다. 속성의 이름은 속성이 액세스하는 웹 서비스의 이름과 동일하며 속성 형식은 웹 서비스의 형식과 동일합니다.

참고 항목

이름 충돌이 있는 경우 웹 서비스에 액세스하기 위한 속성 이름은 RootNamespace_Namespace_ServiceName입니다. 예를 들어 Service1(이)라는 두 개의 웹 서비스를 고려합니다. 이러한 서비스 중 하나가 루트 네임스페이스 WindowsApplication1에 있고 네임스페이스 Namespace1에 있는 경우 My.WebServices.WindowsApplication1_Namespace1_Service1을(를) 사용하여 해당 서비스에 액세스합니다.

My.WebServices 개체의 속성 중 하나에 처음 액세스하면 웹 서비스의 새 인스턴스가 만들어지고 저장됩니다. 해당 속성의 후속 액세스는 웹 서비스의 해당 인스턴스를 반환합니다.

해당 웹 서비스의 속성에 Nothing을(를) 할당하여 웹 서비스를 삭제할 수 있습니다. 속성 setter는 저장된 값에 Nothing을(를) 할당합니다. 속성에 Nothing 이외의 값을 할당하면 setter가 ArgumentException 예외를 throw합니다.

My.WebServices 개체의 속성이 Is 또는 IsNot 연산자를 사용하여 웹 서비스의 인스턴스를 저장하는지 여부를 테스트할 수 있습니다. 해당 연산자를 사용하여 속성 값이 Nothing인지 확인할 수 있습니다.

참고 항목

일반적으로 Is 또는 IsNot 연산자는 비교를 수행하기 위해 속성 값을 읽어야 합니다. 그러나 속성이 현재 Nothing을(를) 저장하는 경우 속성은 웹 서비스의 새 인스턴스를 만든 다음 해당 인스턴스를 반환합니다. 그러나 Visual Basic 컴파일러는 My.WebServices 개체의 속성을 특별히 처리하고 Is 또는 IsNot 연산자가 값을 변경하지 않고 속성의 상태를 확인할 수 있도록 합니다.

예시

이 예제에서는 TemperatureConverter XML 웹 서비스의 FahrenheitToCelsius 메서드를 호출하고 결과를 반환합니다.

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

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

이 예제가 작동하려면 프로젝트에서 Converter(이)라는 웹 서비스를 참조해야 하며 해당 웹 서비스는 ConvertTemperature 메서드를 노출해야 합니다. 자세한 내용은 애플리케이션 웹 서비스 액세스를 참조하세요.

이 코드는 웹 애플리케이션 프로젝트에서 작동하지 않습니다.

요구 사항

프로젝트 형식에 따라 가용성

프로젝트 형식 사용 가능
Windows 애플리케이션 예
클래스 라이브러리 예
콘솔 애플리케이션 예
Windows 컨트롤 라이브러리 예
웹 컨트롤 라이브러리 예
Windows 서비스 예
웹 사이트 아니요

참고 항목