Objeto My.WebServices
Fornece propriedades para criar e acessar uma instância de cada serviço Web XML referenciado pelo projeto corrente.
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 Como: Acessar um serviço da Web no código gerenciado.
The My.WebServices objeto expõe apenas os serviços da Web associados ao projeto corrente. Ele não fornece acesso a serviços da Web declarado em DLLs referenciadas.Para acesso uma Web de serviço que fornece uma DLL, você deve usar o nome qualificado do serviço Web, no formulário DllName.WebServiceName.Para obter mais informações, consulte Acessando Web Services em código gerenciado.
O objeto e suas propriedades não estão disponível para aplicativos da Web.
Propriedades
Cada propriedade do My.WebServices objeto fornece acesso a uma instância de um serviço Web, referenciada pelo projeto corrente. O nome da propriedade é igual ao nome do serviço Web que acessa a propriedade e o tipo de propriedade é o mesmo tipo do serviço Web.
.gif "Observação") Observação: |
|---|
Se houver uma colisão de nomes, o nome da propriedade para acessar um serviço Web é RootNamespace_Namespace_ServiceName.Por exemplo, considere dois serviços da Web chamados Service1. Se um dos seguintes serviços se encontra o namespace de raiz WindowsApplication1 e no espaço para nome Namespace1, você faria acesso desse serviço, usando My.WebServices.WindowsApplication1_Namespace1_Service1. |
Quando você acessar pela primeira vez um o My.WebServices Propriedades do objeto, ele cria uma nova instância do serviço Web e o armazena. Os acessos subseqüentes dessa propriedade retornam a essa instância do serviço Web.
Você pode descartar um serviço Web atribuindo Nothing propriedade de serviço Web. Propriedade setter atribui Nothing o valor armazenado. Se você atribuir qualquer valor diferente de Nothing para a propriedade setter lança um ArgumentException exceção.
Você pode testar se uma propriedade do My.WebServices objeto armazena uma instância do serviço 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 armazena atualmente Nothing, a propriedade cria uma nova instância do serviço Web e, em seguida, retorna essa instância. No entanto, o compilador do Visual Basic trata as propriedades do My.WebServices objeto especialmente e permite que o Is ou IsNot operador para verificar o status da propriedade sem alterar seu valor. |
Tarefas
A tabela a seguir mostra um exemplo de uma tarefa que envolva o My.Forms objeto.
Para |
Consulte |
|---|---|
Chamar um serviço Web de forma assíncrona e manipular um evento quando ele for concluído |
Exemplo
Este exemplo chama o FahrenheitToCelsius método para o 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 esse exemplo funcione, seu projeto deve fazer referência a um serviço Web chamado Converter, e serviço Web deve expor o ConvertTemperature método. Para obter mais informações, consulte Como: Acessar um serviço da Web no código gerenciado.
Esse código não funciona em um projeto de aplicativo Web 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
Tarefas
Como: Acessar um serviço da Web no código gerenciado
Conceitos
Acessar Serviços de Aplicativos da Web