Modelo de código para acessar serviços Web no código gerenciado

Artigo
08/25/2010

Um cliente de serviço Web é qualquer componente, serviço ou aplicativo que faz referência e utiliza um serviço da Web.Vale a pena observar que clientes de serviço da Web não precisam ser um aplicativo baseado em cliente, sistema autônomo um aplicativo de área de trabalho; na maioria dos casos, sistema autônomo clientes de serviço Web podem ser outros aplicativos da Web ou mesmo outros serviços da Web.

Quando estiver acessando Web services em código gerenciado, uma classe proxy e o .NET Framework manipulam toda a infra-estrutura de codificação.Acessar uma Web Services segue estas etapas básicas:

localizar serviço Web que deseja acesso.
criar uma classe de proxy do serviço Web, adicionando uma referência da Web ao seu projeto.
Referencie a classe proxy no código do cliente através da inclusão de seu namespace.
Crie uma instância de classe de proxy de serviço Web no código do cliente.
acesso usando os métodos do proxy de serviço Web.

Para obter mais informações, consulte Como: Acessar um serviço Web no código gerenciado ou Como: Acessar um serviço Web de forma assíncrona em código gerenciado.

Localizar um serviço Web e adicionando uma referência da Web

Para simplificar o modelo de codificação, aplicativos escritos em código gerenciado usam uma referência da Web para representar localmente cada serviço Web.Você adiciona uma referência da Web no seu projeto usando a caixa de diálogo Add Web Reference.Esta caixa de diálogo oferece suporte a navegação endereços da Web para um serviço Web.Para obter mais informações, consulte Localizar serviços da Web e Referências da Web.

Referencie a classe proxy

A classe proxy gerada tem seu próprio namespace associado a ela, e você deve adicionar o namespace ao seu aplicativo cliente antes que você possa criar uma instância dessa classe.Para obter mais informações, consulte usando Diretiva (C#) ou Referências e as declarações Imports (Visual Basic .NET).

Crie uma instância da classe proxy

Antes que você possa chamar qualquer dos métodos da classe proxy, você deve primeiro criar uma instância dessa classe.Esse processo não difere em nada do de criar uma instância de qualquer outra classe.Para obter mais informações, consulte novo (C#) ou Declaração de Variável de Objeto (Visual Basic .NET).

serviço Web usando o proxy de acesso

Para acesso um método de serviço Web, seu aplicativo cliente chama o correspondente método síncrono ou métodos assíncrono do objeto proxy.Esses métodos por sua vez fazem o trabalho necessário para remoto telefonar durante a transmissão para chamar o método de serviço Web desejado.Por padrão, clsistema autônomos proxy usa SOAP para acessar o método de serviço Web, sistema autônomo SOAP oferece suporte ao conjunto mais completa dos tipos de dados dos três protocolos suportados (HTTP-GET, HTTP-POST e HTTP-SOAP).Para obter mais informações, consulte Formatos Wire Serviço Web XML.

Resumo

Usando uma classe proxy que Visual Studio gerou diretamente partir da descrição do serviço de um serviço Web, acessar uma Web Services em código gerenciado é um processo relativamente simples.A classe proxy faz o trabalho para transformar a chamada de método em uma mensagem de solicitação e a mensagem de resposta de volta para um valor de retorno de método.

A figura a seguir mostra o Relação de um aplicativo que chama um serviço Web, que por sua vez chama outro serviço Web para obter informações sobre preços.Neste exemplo, o serviço Web Get de preços corrente é um provedor de serviços da Web e um cliente de serviço da Web.

Clientes de serviço Web e serviços da Web