Objeto My.WebServices (Visual Basic)
Fornece propriedades para criar e acessar uma única instância de cada serviço XML da Web referenciado pelo projeto atual.
Comentários
The My.WebServices object provides an instance of each Web service referenced by the current project. Each instance is instantiated on demand. You can access these Web services through the properties of the My.WebServices object. The name of the property is the same as the name of the Web service that the property accesses. Any class that inherits from SoapHttpClientProtocol is a Web service. For information about adding Web services to a project, see Acessando os serviços do aplicativo da Web (Visual Basic).
O My.WebServices objeto expõe apenas os serviços da Web associados ao projetoatual. Ele não fornece acesso aos serviços da Web declarado em DLLs referenciadas. Para acessar um serviço Web que fornece a uma DLL, você deve usar o nome qualificado do serviço da Web , no formulário DllName.WebServiceName. For more information, see Acessando os serviços do aplicativo da Web (Visual Basic).
O objeto e suas propriedades não estão disponíveis para aplicativos Web .
Properties
Cada propriedade da My.WebServices objeto fornece acesso a uma instância de um serviço Web referenciado pelo projetoatual. 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 tipo do serviço Web .
Observação |
---|
Se houver um conflito de nome, o nome de propriedade para acessar um serviço Web é RootNamespace_Namespace_ServiceName. Por exemplo, considere dois serviços da Web chamados Service1. Se um desses serviços está na raizdonamespaceWindowsApplication1 e no namespace Namespace1, você pode acessar o serviço por meio de My.WebServices.WindowsApplication1_Namespace1_Service1. |
Quando você acessa pela primeira vez um da My.WebServices objetopropriedades, 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 dispor de um serviço Web atribuindo Nothing para a propriedade para esse serviço da Web . A propriedade setter atribui Nothing para o valor armazenado. Se você atribuir qualquer valor diferente de Nothing para a propriedade, o setter lança um ArgumentException exceção.
Você pode teste 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.WebServicesobjeto especialmente e permite que o Is ou IsNotdeoperador para verificar o status da propriedade sem alterar seu valor. |
Tasks
A tabela a seguir mostra um exemplo de uma tarefa que envolvem o My.Forms objeto.
To |
See |
Chamar um serviço Web de forma assíncrona e manipular um evento quando ele for concluído |
Como: Chamar um serviço Web de forma assíncrona (Visual Basic) |
Exemplo
Este exemplo chama o FahrenheitToCelsiusométodo da TemperatureConverterXMLWeb service 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 que o serviço Web deve expor a ConvertTemperature método. For more information, see Acessando os serviços do aplicativo da Web (Visual Basic).
Esse código não funciona em umprojetodeaplicativode Web.
Requirements
Availability by Project Type
Project type |
Available |
Windows Application |
Yes |
Class Library |
Yes |
Console Application |
Yes |
Windows Control Library |
Yes |
Web Control Library |
Yes |
Windows Service |
Yes |
Web Site |
No |