Como: Adicionar e remover referências da Web

Um referência da Web permite que um projeto consuma um ou mais XML Web Services.Use the Caixa de Diálogo Add Web Reference to search for Web services locally, on a local area network, or on the Internet.

Após adicionar uma referência da Web ao seu projeto atual, você pode chamar quaisquer métodos expostos pelos serviço da Web.Para obter detalhes, consulte:Como: Chamar um Web Service.

For information about creating a Web service class, see Passo a passo: Building a Serviço Web XML Basic Using ASP.NET.

Para adicionar uma referência da Web a um projeto

  1. Em Solution Explorer, clique com o botão direito do mouse no nome do projeto para adicionar o serviço da Web para e clique Add Web Reference.

    A caixa de diálogo Add Web Reference é exibida.

  2. 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 mais informações, consulte “As configurações de proxy neste computador não estão configuradas corretamente para descoberta da Web” no SDK do Visual Studio 2005.

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

  4. 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.A abertura de projetos ou componentes no ambiente de desenvolvimento integrado (IDE) pode executar código em seu computador local.Para obter mais informações, consulte Visão Geral sobre Ameças de Segurança em Aplicativos da Web e Segurança de Acesso de código.

  5. 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.Para obter mais informações sobre caracteres que não são permitidos em um nome de referência da Web, consulte Caixa de Diálogo Add Web Reference.Visual Web Developer creates a namespace based on the Web reference name by building a nested folder hierarchy.Inside the innermost folder, a .wsdl file that references the Web service is created, along with supporting files, such as discovery (.disco and .discomap) files, that include information about where the Web service is located.

  6. Clique em Add Reference.

    Se o seu site não tiver um, o Visual Studio cria uma pasta App_WebReferences.Em seguida, ele cria os arquivos necessários para a classe proxy usando o nome fornecido na etapa 5.

Removendo uma referência da Web

Se o projeto não precisa mais de uma referência da Web para um XML Web Service, você pode remover a referência do seu projeto.

Para remover uma referência da Web de um projeto

  • In Solution Explorer, right-click the Web reference and then click Delete.

    Todas as informações de referência são removidas do projeto e do armazenamento local.

Consulte também

Tarefas

Como: Chamar um Web Service

Passo a passo: Criando e usando um serviço da Web do ASP.NET no Visual Web Developer

Passo a passo: Building a Serviço Web XML Basic Using ASP.NET

Conceitos

Visão Geral sobre XML Web Services