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

Uma referência de serviço permite que um projeto para o acesso um ou mais Windows Communication Foundation (WCF) services. Use o Add Service Reference caixa de diálogo para procurar serviços WCF na solução atual, localmente, em uma rede local ou na Internet.

Adicionando uma referência de serviço

Para adicionar uma referência a um serviço externo

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 endereço caixa, digite a URL para o serviço e, em seguida, clique em Ir para procurar o serviço. Se o serviço implementa a segurança de nome de usuário/senha, você pode ser solicitado um nome de usuário e senha.

   Dica

   Você só deve fazer referência serviços de uma fonte confiável.Adicionar referências de uma fonte não confiável pode comprometer a segurança.

   Dica

   Você também pode selecionar o URL de uma lista suspensa que armazena as URLs de 15 pela última vez em que os metadados de serviço válido foi encontrado.

   Uma barra de progresso é exibida enquanto a pesquisa está sendo executada. Você pode interromper a pesquisa a qualquer momento clicando em Parar.

3. No Service lista, expanda o nó do serviço que você deseja usar e selecione um contrato de serviço.

4. No espaço para nome , digite o espaço para nome que você deseja usar para a referência.

5. Clique em OK para adicionar a referência ao projeto.

   Um cliente de serviço (proxy) é gerado e metadados que descrevem o serviço é adicionado ao arquivo app. config.

Para adicionar uma referência a um serviço na solução atual

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. Clique em descobrir.

   Todos os serviços WCF na solução atual são adicionados para o Service lista.

3. No Service lista, expanda o nó do serviço que você deseja usar e selecione um contrato de serviço.

4. No espaço para nome , digite o espaço para nome que você deseja usar para a referência.

5. Clique em OK para adicionar a referência ao projeto.

6. Um cliente de serviço (proxy) é gerado e metadados que descrevem o serviço é adicionado ao arquivo app. config.

Atualizando uma referência de serviço

Ao longo do tempo, os metadados para um serviço WCF podem ser alterados, exigindo que a referência de serviço seja atualizado.

Para atualizar uma referência de serviço

• Em Solution Explorer, a referência de serviço com o botão direito e, em seguida, clique em Update Service Reference.

  Uma caixa de diálogo de progresso é exibida enquanto a referência é atualizada de seu local original e o cliente do serviço é gerada novamente para refletir quaisquer alterações nos metadados.

Removendo uma referência de serviço

Se uma referência de serviço não estiver sendo usada, você pode removê-lo de sua solução.

Para remover uma referência de serviço

• Em Solution Explorer, a referência de serviço com o botão direito e, em seguida, clique em Excluir.

  O cliente do serviço será removido da solução e os metadados que descrevem o serviço serão removido do arquivo app. config.

  Dica

  Qualquer código que faz referência a referência de serviço terá que ser removidos manualmente.

Consulte também

Tarefas

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

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

Outros recursos

Consuming ASMX and WCF Services Sample