Obiekt My.WebServices

Artykuł
02/27/2013

Zapewnia właściwości służące do tworzenia i uzyskiwania dostępu do pojedyncze wystąpienie każdej z usług XML sieci Web odwołują się bieżącego projektu.

Uwagi

My.WebServices Obiektu zapewnia wystąpienie każdej z usług sieci Web odwołuje się bieżącego projektu.Każde wystąpienie jest utworzone na żądanie.Można uzyskać dostęp tych usług sieci Web za pomocą właściwości My.WebServices obiektu.Nazwa właściwości jest taka sama jak nazwa usługi sieci Web, który uzyskuje dostęp do właściwości.Każda klasa, która dziedziczy z SoapHttpClientProtocol jest usługą sieci Web.Aby uzyskać informacje dotyczące dodawania usług sieci Web do projektu, zobacz Uzyskiwanie dostępu do usługi sieci Web aplikacji (Visual Basic).

My.WebServices Obiekt udostępnia tylko usług sieci Web skojarzonych z bieżącym projektem.Nie zapewnia jednak dostęp do usług sieci Web zadeklarowane w dll, do której następuje odwołanie.Do dostępu usługi sieci Web, która zapewnia bibliotekę DLL, należy użyć kwalifikowanej nazwy usługi sieci Web w postaci Nazwa_pliku_dll. WebServiceName.Aby uzyskać więcej informacji, zobacz Uzyskiwanie dostępu do usługi sieci Web aplikacji (Visual Basic).

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

Właściwości

Każda właściwość My.WebServices obiektu zapewnia dostęp do wystąpienia usługi sieci Web, odwołanie do bieżącego projektu.Nazwa właściwości jest taka sama, jak nazwa usługi sieci Web, który uzyskuje dostęp do właściwości i typ właściwości jest taki sam, jak typ usługi sieci Web.

[!UWAGA]

W przypadku kolizji nazw, nazwa właściwości do uzyskiwania dostępu do usługi sieci Web jest RootNamespace_obszaru nazw_ServiceName.Na przykład, rozważmy dwie usługi sieci Web o nazwie Service1.Jeśli jeden z tych usług jest głównego obszaru nazw WindowsApplication1 i w obszarze nazw Namespace1, czy dostęp tej usługi za pomocą My.WebServices.WindowsApplication1_Namespace1_Service1.

Kiedy użytkownik najpierw dostępu do jednego z My.WebServices właściwości obiektu tworzy nowe wystąpienie usługi sieci Web i przechowuje go.Kolejne uzyskuje dostęp do tej właściwości zwracają to wystąpienie usługi sieci Web.

Można zbyć usługi sieci Web, przypisując Nothing do właściwości dla tej usługi sieci Web.Przypisuje ustawiająca właściwość Nothing do zapisanych wartości.Po przypisaniu wartości inne niż Nothing do właściwości, metody ustawiającej wyrzuca ArgumentException wyjątku.

Można sprawdzić, czy właściwość My.WebServices obiektu przechowuje wystąpienie usługi sieci Web przy użyciu Is lub IsNot operatora.Można użyć tych podmiotów gospodarczych, aby sprawdzić, czy wartość właściwości jest Nothing.

[!UWAGA]

Zazwyczaj Is lub IsNot operator musi odczytać wartość właściwości przeprowadzenie porównania.Jednakże jeśli właściwość przecho wuje obecnie Nothing, właściwość tworzy nowe wystąpienie usługi sieci Web, a następnie zwraca instancję.Jednak kompilator Visual Basic traktuje właściwości My.WebServices specjalnie obiekt i pozwala na Is lub IsNot operatora, aby sprawdzić stan właściwości bez zmieniania jej wartość.

Przykład

W tym przykładzie wywołuje FahrenheitToCelsius metoda TemperatureConverter usługi XML sieci Web i zwraca wynik.

Function ConvertFromFahrenheitToCelsius( 
    ByVal dFahrenheit As Double) As Double

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

W tym przykładzie do pracy projektu musi odwoływać się usługi sieci Web o nazwie Converter, i że usługa sieci Web musi ujawnić ConvertTemperature metody.Aby uzyskać więcej informacji, zobacz Uzyskiwanie dostępu do usługi sieci Web aplikacji (Visual Basic).

Ten kod nie działa w projekcie aplikacji sieci Web.

Wymagania

Dostępność wg typu projektu

Typ projektu	Dostępne
Aplikacja systemu Windows	Tak
Biblioteka klas	Tak
Aplikacja konsoli	Tak
Biblioteka formantów systemu Windows	Tak
Biblioteka formantów sieci Web	Tak
Usługa systemu Windows	Tak
Witryna sieci Web	Nr