Compartilhar via

Objeto My.WebServices

Fornece propriedades para criar e acessar uma única instância de cada serviço Web XML referenciado pelo projeto atual.

Observações

O My.WebServices objeto fornece uma instância de cada serviço Web referenciado pelo projeto atual. Cada instância é instanciada sob demanda. Você pode acessar esses serviços Web por meio das propriedades do My.WebServices objeto. O nome da propriedade é o mesmo que o nome do serviço Web que a propriedade acessa. Qualquer classe que herda de SoapHttpClientProtocol é um serviço Web. Para obter informações sobre como adicionar serviços Web a um projeto, consulte Acessando os Serviços Web de Aplicativos.

O My.WebServices objeto expõe apenas os serviços Web associados ao projeto atual. Ele não fornece acesso aos serviços Web declarados em DLLs referenciadas. Para acessar um serviço Web fornecido por uma DLL, você deve usar o nome qualificado do serviço Web, no formato DllName. WebServiceName. Para obter mais informações, consulte Acessando os Serviços Web de Aplicativos.

O objeto e suas propriedades não estão disponíveis para aplicativos Web.

Propriedades

Cada propriedade do My.WebServices objeto fornece acesso a uma instância de um serviço Web referenciado pelo projeto atual. O nome da propriedade é o mesmo que o nome do serviço Web que a propriedade acessa e o tipo de propriedade é o mesmo que o tipo do serviço Web.

Observação

Se houver uma colisão de nome, o nome da propriedade para acessar um serviço Web será RootNamespace_Namespace_ServiceName. Por exemplo, considere dois serviços Web nomeados Service1. Se um desses serviços estiver no namespace WindowsApplication1 raiz e no namespace Namespace1, você acessará esse serviço usando My.WebServices.WindowsApplication1_Namespace1_Service1.

Quando você acessa uma das My.WebServices propriedades do objeto pela primeira vez, ela cria uma nova instância do serviço Web e a armazena. Os acessos subsequentes dessa propriedade retornam essa instância do serviço Web.

Você pode descartar um serviço Web atribuindo Nothing à propriedade desse serviço Web. O setter de propriedade atribui Nothing ao valor armazenado. Se você atribuir qualquer valor diferente da Nothing propriedade, o setter gerará uma exceção ArgumentException .

Você pode testar se uma propriedade do My.WebServices objeto armazena uma instância do serviço Web usando o operador ou IsNot o Is operador. Você pode usar esses operadores para verificar se o valor da propriedade é Nothing.

Observação

Normalmente, o operador ou o IsIsNot operador precisa ler o valor da propriedade para executar a comparação. No entanto, se a propriedade armazenar no momento Nothing, a propriedade criará uma nova instância do serviço Web e retornará essa instância. No entanto, o compilador do Visual Basic trata especialmente as propriedades do My.WebServices objeto e permite que o operador ou IsNot o Is operador verifique o status da propriedade sem alterar seu valor.

Exemplo

Este exemplo chama o FahrenheitToCelsius método do TemperatureConverter serviço Web XML e retorna o resultado.

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

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

Para que este exemplo funcione, seu projeto deve fazer referência a um serviço Web chamado Convertere esse serviço Web deve expor o ConvertTemperature método. Para obter mais informações, consulte Acessando os Serviços Web de Aplicativos.

Esse código não funciona em um projeto de aplicativo Web.

Requisitos

Disponibilidade por tipo de projeto

Tipo de projeto Disponível
Aplicativo do Windows Sim
Biblioteca de Classes Sim
Aplicativo de console Sim
Biblioteca de Controle do Windows Sim
Biblioteca de Controles da Web Sim
Serviço do Windows Sim
Site da web Não

Consulte também

  • Last updated on