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 pesquisar os 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 do usuário/senha, você pode ser solicitado um nome de usuário e senha.

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

   Observação
   Você também pode selecionar o URL de uma lista suspensa que armazena os últimos 15 URLs onde 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 Namespace , 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 Namespace , 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 de 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ê poderá removê-lo a 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.

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

Consulte também

Tarefas

Como: Adicione uma referência a um serviço da Web

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

Outros recursos

Consuming ASMX and WCF Services Sample