Objeto My.WebServices

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

Comentários

O objeto My.WebServices fornece uma instância de cada Serviço Web referenciado pelo projeto atual.Cada instância é instanciada por demanda.Você pode acessar esses serviços da Web através das propriedades do objeto My.WebServices.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 os serviços da Web a um projeto, consulte Acessando os serviços do aplicativo da Web (Visual Basic).

O My.WebServices objeto expõe apenas os serviços da Web associados ao projeto atual.Ele não fornece acesso aos serviços da Web declarado em DLLs referenciadas.Para acessar um serviço da Web que fornece a uma DLL, você deve usar o nome qualificado do serviço da Web, no formulário DllName. WebServiceName.Para obter mais informações, consulte Acessando os serviços do aplicativo da Web (Visual Basic).

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

Propriedades

Cada propriedade da 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 da Web que a acessa a propriedade e o tipo de propriedade é o mesmo que o tipo do serviço Web.

Observação
Se houver um conflito de nome, o nome de propriedade para acessar um serviço da Web é RootNamespace_espaço para nome_ServiceName.Por exemplo, considere dois serviços da Web chamados Service1.Se um desses serviços está no namespace raiz WindowsApplication1 e no namespace Namespace1, você poderia acessar esse serviço usando My.WebServices.WindowsApplication1_Namespace1_Service1.

Quando você acessa pela primeira vez um do My.WebServices propriedades do objeto, ele cria uma nova instância do serviço da Web e o armazena.Os acessos subseqüentes dessa propriedade retornam essa instância do serviço da Web.

Você pode descartar um serviço da Web atribuindo Nothing para a propriedade para o serviço da Web.A propriedade setter atribui Nothing para o valor armazenado.Se você atribuir qualquer valor diferente de Nothing à propriedade, o setter lança um ArgumentException exceção.

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

Observação

Normalmente, o Is ou IsNot operador tem que ler o valor da propriedade para executar a comparação.No entanto, se a propriedade atualmente armazena Nothing, a propriedade cria uma nova instância do serviço da Web e, em seguida, retorna essa instância.No entanto, o compilador Visual Basic trata as propriedades da My.WebServices especialmente de objeto e permite que o Is ou IsNot operador para verificar o status da propriedade sem alterar seu valor.

Exemplo

Este exemplo chama o FahrenheitToCelsius método da TemperatureConverter XML Web Services e retorna o resultado.

Function ConvertFromFahrenheitToCelsius( 
    ByVal dFahrenheit As Double) As Double

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

Para esse exemplo funcione, seu projeto deve fazer referência a um serviço da Web chamado Converter, e o serviço da Web deve expor a ConvertTemperature método.Para obter mais informações, consulte Acessando os serviços do aplicativo da Web (Visual Basic).

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

Requisitos

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Não

Consulte também

Referência

SoapHttpClientProtocol

ArgumentException

Conceitos

Acessando os serviços do aplicativo da Web (Visual Basic)