Como adicionar uma referência a um serviço Web

Serviços Web XML, também conhecido como serviços ASMX, foram o predecessor de Windows Communication Foundation (WCF). Você pode acessar os serviços da Web, adicionando uma referência de serviço, como faria com qualquer outro serviço do WCF. Todas as referências adicionadas desta maneira se destina a versão mais recente do .NET Framework.

Para aplicativos que foram criados em uma versão anterior do Visual Studio, você ainda pode adicionar uma referência da Web que se destina a versão 2.0 da .NET Framework. Para fazer isso, siga o procedimento descrito na seção a seguir.

Observação

Uma referência da Web deve ser adicionada somente se o seu aplicativo destina-se a versão 2.0 da .NET Framework.Para adicionar uma referência de serviço que se destina a versão atual da .NET Framework, consulte Como adicionar, atualizar ou remover uma referência de serviço.

Para adicionar uma referência da Web a um projeto

1. Em Solution Explorer, clique com o botão direito no nome do projeto que você deseja adicionar o serviço e, em seguida, clique em Add Service Reference.

   O Add Service Reference caixa de diálogo aparece.

2. No Add Service Reference caixa de diálogo, clique no Advanced botão.

   O Configurações de referência de serviço caixa de diálogo aparece.

3. No Configurações de referência de serviço caixa de diálogo, clique em Add Web Reference.

   O Add Web Reference caixa de diálogo aparece.

4. Na caixa de URL, digite o URL do serviço da Web a ser usada. Se você não souber o URL, use os links no painel de procura para localizar o serviço da Web que você deseja.

   Observação

   Se você está desenvolvendo um aplicativo da Web em um computador que está atrás de um firewall, e seu aplicativo consumirá serviços da Web de fora do firewall, você deve incluir o endereço e a porta do servidor proxy da sua rede no URL.Peça ao administrador da rede para fornecer esta parte do caminho do URL.Para obter mais informações, consulte As configurações de proxy neste computador não estão configuradas corretamente para descoberta para Web..

5. Na caixa Web services found at this URL, selecione o serviço da Web a ser usado.

6. Verifique se o projeto pode usar o serviço da Web, e que todo código externo fornecido é confiável.

   Observação de segurança
   Quando você abre um projeto para edição que inclui uma referência da Web, um arquivo proxy local para o serviço da Web consumido é executado em um processo de devenv.exe inicializado por um usuário confiável, você mesmo.Abrir projetos ou componentes no ambiente de desenvolvimento integrado (IDE) pode executar código no computador local.Para obter mais informações, consulte Code Access Security.

7. No campo Web reference name, digite um nome que você irá usar em seu código para acessar o serviço da Web selecionado por programação.

   Observação

   By default, Web references are assigned a namespace that corresponds to their server name.You can change this value and enter a custom namespace name.There are some limitations on acceptable namespace names.For more information about characters that are not allowed in a Web reference name, see Add Web Reference Dialog Box.Um espaço para nome baseado no nome de referência da Web é criado com a criação de uma hierarquia de pastas aninhadas.Dentro da pasta mais interna, é criado um arquivo. WSDL que referencia o serviço da Web, junto com arquivos, como detecção (incluíndo e. discomap), que incluem informações sobre onde se encontra o serviço da Web de suporte.

8. Clique em Add Reference.

   Se seu site de projeto ainda não tiver uma, Visual Studio cria um WebReferences pasta. Em seguida, ele cria arquivos necessários para a classe de proxy usando o nome que você forneceu na etapa 7.

Consulte também

Tarefas

Como adicionar, atualizar ou remover uma referência de serviço

Referência

Caixa de diálogo Adicionar Referência de Serviço

Conceitos

Serviços do Windows Communication Foundation e WCF Data Services no Visual Studio

Web References in Visual Studio

Outros recursos

Consuming ASMX and WCF Services Sample