Como: Adicione uma referência a um serviço da 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. Quaisquer 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çãoObservação

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

To add a Web reference to a project

  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. In the URL box, enter the URL of the Web service to use. If you do not know the URL, use the links in the browse pane to locate the Web service you want.

    ObservaçãoObservação

    If you are developing a Web application on a computer that is behind a firewall, and your application will consume Web services from outside the firewall, you must include the address and port of your network's proxy server in the URL. Ask your network administrator to furnish this part of the URL path. For more information, see As configurações de proxy neste computador não estão configuradas corretamente para descoberta da Web..

  5. In the Web services found at this URL box, select the Web service to use.

  6. Verify that your project can use the Web service, and that any external code provided is trustworthy.

    Observação de segurançaObservação sobre segurança

    When you open a project for editing that includes a Web reference, a local proxy file for the Web service consumed runs in a process of Devenv.exe started by a trusted user, yourself. Abrir projetos ou componentes no ambiente de desenvolvimento integrado (IDE) pode executar código no computador local. For more information, see Code Access Security.

  7. In the Web reference name field, enter a name that you will use in your code to access the selected Web service programmatically.

    ObservaçãoObservaçã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 Caixa de Diálogo Add Web Reference. 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, com o suporte a arquivos, como detecção (incluíndo e. discomap), que incluem informações sobre onde se encontra o serviço da Web.

  8. Click Add Reference.

    Se seu site de projeto ainda não tiver uma, Visual Studio cria um WebReferences pasta. Em seguida, ele cria os 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

Adicionar caixa de diálogo de referência de serviço

Conceitos

Os serviços do Windows Communication Foundation e serviços de dados do WCF em Visual Studio

Referências da Web no Visual Studio

Outros recursos

Consuming ASMX and WCF Services Sample