Referências da Web no Visual Studio

Artigo
10/15/2014

Para simplificar o desenvolvimento de aplicativos do cliente serviço Web XML, Visual Studio fornece referências da Web.As referências da Web diferem das referências e componentes tradicionais; em vez de fazer referência a um componente ou uma biblioteca de classes instalados no computador local, uma referência da Web fornece acesso a um recurso que está disponível usando um protocolo de Internet, como SOAP ou HTTP.

Na prática, uma referência da Web é uma classe de proxy gerada que representa localmente a funcionalidade exposta de um serviço Web XML.A classe de proxy Define métodos que representam os reais métodos expostos por um serviço Web XML.Quando seu aplicativo cria uma instância da classe de proxy, seu aplicativo pode chamar os métodos XML do serviço Web como se o serviço Web XML fosse um componente disponível localmente.Para obter instruções sobre como criar uma referência da Web, consulte Como: Adicionar e remover referências da Web.

Observação:
Para disponibilizar serviços da Web XML fora de um firewall para o navegador da Web, ao criar a referência da Web em Visual Studio, você deve especificar explicitamente o endereço e a porta do servidor proxy da sua rede.

A linguagem de programação de uma classe de proxy gerada será igual a linguagem de programação do serviço Web que representa a classe de proxy.Se você criar a classe de proxy independentemente da Visual Studio (por exemplo, usando uma ferramenta .NET Framework), o linguagem de programação depende em Qual ferramenta você usar.Por exemplo, se você usar WSDL.exe, você especifica a linguagem de programação na linha de comando como C# ou Visual Basic.Se você usar SProxy.exe, a linguagem de programação é Visual C++.Para obter mais informações, consulte Tool WSDL (Web Serviços Description Idioma) (WSDL.exe).

Em tempo de design, a classe de proxy permite a você usar a conclusão da instrução para os métodos do serviço Web XML.Em tempo de execução, uma chamada para um método do objeto proxy é processada e codificada como uma mensagem de solicitação SOAP.Se o serviço Web XML não tiver suporte para SOAP, a classe de proxy usa HTTP GET e POST.Em seguida, a mensagem é enviada para o Serviço da Web de destino para processamento.Se a descrição do serviço define uma mensagem de resposta, o objeto de proxy processa esta mensagem e retorna uma resposta ao seu aplicativo.

Gerenciando Referências da Web

Você pode renomear ou modificar referências da Web ou atualizá-las se tiver alterado o serviço Web referenciado.Para obter detalhes, consulte Como: Renomear uma referência da Web de um projeto e Como: Atualizar uma referência da Web de um projeto.

Propriedade de Comportamento da URL

Cada referência da Web em seu projeto interage com uma classe de proxy que é usada para acessar o serviço Web.Você pode usar a propriedade URL da referência da Web para especificar a URL para o XML Web Service.Em ASP.NET 1.1, uma referência da Web pode usar um URL estático ou um URL dinâmico.No ASP.NET 2.0 e posterior, uma referência da Web obtém o URL dinamicamente.Para obter mais informações, consulte Localizar serviços da Web.

Quando você cria uma referência da Web em Visual Studio usando a caixa de diálogo Add Web Reference,essa propriedade é definida por padrão para o URL de serviço da Web XML que você selecionar, que é um URL estático.Se você deixar o comportamento URL definido como o valor padrão de estático, a classe de proxy define a propriedade URL usando uma URL embutida quando você cria uma instância da classe.

Se você definir a propriedade do comportamento URL da referência da Web para dinâmico, o aplicativo obtém, do elemento appSettings, o URL ,em tempo de execução, do arquivo de configuração do aplicativo.

Consulte também

Referências da Web no Visual Studio

Gerenciando Referências da Web

Propriedade de Comportamento da URL

Consulte também

Tarefas

Conceitos

Referência

Recursos adicionais