My.WebServices — Obiekt

  • Artykuł

Udostępnia właściwości tworzenia i uzyskiwania dostępu do pojedynczego wystąpienia każdej usługi sieci Web XML, do których odwołuje się bieżący projekt.

Uwagi

Obiekt My.WebServices udostępnia wystąpienie każdej usługi sieci Web, do których odwołuje się bieżący projekt. Każde wystąpienie jest tworzone na żądanie. Dostęp do tych usług sieci Web można uzyskać za pomocą właściwości My.WebServices obiektu. Nazwa właściwości jest taka sama jak nazwa usługi sieci Web, do którego uzyskuje dostęp właściwość. Każda klasa dziedziczona z SoapHttpClientProtocol klasy jest usługą sieci Web. Aby uzyskać informacje na temat dodawania usług sieci Web do projektu, zobacz Accessing Application Web Services (Uzyskiwanie dostępu do usług sieci Web aplikacji).

Obiekt My.WebServices uwidacznia tylko usługi sieci Web skojarzone z bieżącym projektem. Nie zapewnia dostępu do usług sieci Web zadeklarowanych w odwołanych bibliotekach DLL. Aby uzyskać dostęp do usługi sieci Web udostępnianej przez bibliotekę DLL, należy użyć kwalifikowanej nazwy usługi sieci Web w postaci DllName.Nazwa usługi sieci Web. Aby uzyskać więcej informacji, zobacz Uzyskiwanie dostępu do usług sieci Web aplikacji.

Obiekt i jego właściwości nie są dostępne dla aplikacji internetowych.

Właściwości

Każda właściwość My.WebServices obiektu zapewnia dostęp do wystąpienia usługi sieci Web, do których odwołuje się bieżący projekt. Nazwa właściwości jest taka sama jak nazwa usługi sieci Web, do którego uzyskuje dostęp właściwość, a typ właściwości jest taki sam jak typ usługi sieci Web.

Uwaga

Jeśli występuje kolizja nazw, nazwa właściwości uzyskiwania dostępu do usługi sieci Web to RootNamespace_Namespace_ServiceName. Rozważmy na przykład dwie usługi sieci Web o nazwie Service1. Jeśli jedna z tych usług znajduje się w głównej przestrzeni nazw WindowsApplication1 i w przestrzeni nazw Namespace1, możesz uzyskać dostęp do tej usługi przy użyciu polecenia My.WebServices.WindowsApplication1_Namespace1_Service1.

Podczas pierwszego uzyskiwania dostępu do jednej z My.WebServices właściwości obiektu tworzy nowe wystąpienie usługi sieci Web i przechowuje je. Kolejne dostępy tej właściwości zwracają to wystąpienie usługi sieci Web.

Usługę sieci Web można usunąć, przypisując Nothing do właściwości dla tej usługi sieci Web. Ustawiająca właściwość przypisuje Nothing do przechowywanej wartości. Jeśli przypiszesz dowolną wartość inną niż Nothing do właściwości, setter zgłasza ArgumentException wyjątek.

Możesz sprawdzić, czy właściwość My.WebServices obiektu przechowuje wystąpienie usługi sieci Web przy użyciu Is operatora or IsNot . Za pomocą tych operatorów można sprawdzić, czy wartość właściwości to Nothing.

Uwaga

Is Zazwyczaj operator or IsNot musi odczytać wartość właściwości, aby przeprowadzić porównanie. Jeśli jednak właściwość jest obecnie przechowywana Nothing, właściwość tworzy nowe wystąpienie usługi sieci Web, a następnie zwraca to wystąpienie. Jednak kompilator języka Visual Basic traktuje właściwości My.WebServices obiektu specjalnie i umożliwia operatorowi Is lub IsNot sprawdzenie stanu właściwości bez zmiany jego wartości.

Przykład

Ten przykład wywołuje metodę FahrenheitToCelsiusTemperatureConverter usługi sieci Web XML i zwraca wynik.

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

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

Aby ten przykład działał, projekt musi odwoływać się do usługi sieci Web o nazwie Converter, a usługa sieci Web musi uwidocznić metodę ConvertTemperature . Aby uzyskać więcej informacji, zobacz Uzyskiwanie dostępu do usług sieci Web aplikacji.

Ten kod nie działa w projekcie aplikacji internetowej.

Wymagania

Dostępność według typu projektu

Typ projektu Dostępny
Aplikacja systemu Windows Tak
Biblioteka klas Tak
Aplikacja konsolowa Tak
Biblioteka kontrolek systemu Windows Tak
Biblioteka formantów sieci Web Tak
Usługa systemu Windows Tak
Witryna sieci Web Nie.

Zobacz też