Adicionar, atualizar ou remover uma referência de serviço de dados do WCF

Para projetos do .NET Framework, a referência de serviço permite que um projeto acesse um ou mais Serviços de Dados do WCF. Use a caixa de diálogo Adicionar Referência de Serviço para pesquisar os Serviços de Dados do WCF na solução atual, localmente, em uma rede local ou na Internet.

Para projetos do .NET Core, você pode usar o nó Serviços Conectados no Gerenciador de Soluções para acessar o Provedor de Referência de Serviços Web do Microsoft WCF, que permite gerenciar as referências do serviço de dados WCF (Windows Communication Foundation).

Observação

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio neste artigo. Você pode estar usando uma edição diferente do Visual Studio ou configurações de ambiente diferentes. Para obter mais informações, consulte Personalizar o IDE.

Pré-requisitos

As ferramentas do WCF não estão instaladas com a carga de trabalho do .NET; use o Instalador do Visual Studio para modificar sua instalação. No instalador, escolha Windows Communication Foundation em Componentes Individuais. Confira Modificar o Visual Studio.

Adicionar uma referência de serviço WCF

Para adicionar uma referência a um serviço externo (projetos do .NET Framework)

1. No Gerenciador de Soluções, clique com o botão direito do mouse no nome do projeto ao qual você deseja adicionar o serviço e selecione Adicionar Referência de Serviço.

   A caixa de diálogo Adicionar Referência de Serviço é exibida.

2. Na caixa Endereço , insira a URL do serviço e selecione Ir para pesquisar o serviço. Se o serviço implementar a segurança de nome de usuário e senha, você poderá receber uma solicitação de nome de usuário e senha. Você também pode escolher um serviço em sua própria solução. Escolha o botão Descobrir e escolha Serviços na Solução.

   Observação

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

   Você também pode selecionar a URL na lista de endereços , que armazena as 15 URLs anteriores nas quais os metadados de serviço válidos foram encontrados.

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

3. Na lista Serviços , expanda o nó para o serviço que você deseja usar e selecione um conjunto de entidades.

4. Na caixa Namespace , insira o namespace 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 são adicionados ao arquivo app.config .

Para adicionar uma referência a um serviço externo (projetos do .NET Core, incluindo .NET 5 e posterior)

1. No Gerenciador de Soluções, dê um duplo clique ou toque no nó Serviços Conectados.

   A guia Configurar Serviços é aberta.

2. Escolha o Provedor de Referência do Serviço Web do Microsoft WCF.

   A caixa de diálogo Configurar Referência do Serviço Web do WCF é exibida.

   

3. Na caixa URI , insira a URL do serviço e selecione Ir para pesquisar o serviço. Se o serviço implementar a segurança de nome de usuário e senha, você poderá receber uma solicitação de nome de usuário e senha.

   Observação

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

   Você também pode selecionar a URL na lista de URI , que armazena as 15 URLs anteriores nas quais metadados de serviço válidos foram encontrados.

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

4. Na lista Serviços , expanda o nó para o serviço que você deseja usar e selecione um conjunto de entidades.

5. Na caixa Namespace , insira o namespace que você deseja usar para a referência.

6. Clique em Concluir para adicionar a referência ao projeto.

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

Para adicionar uma referência a um serviço na solução atual (projetos do .NET Framework)

1. No Gerenciador de Soluções, clique com o botão direito do mouse no nome do projeto ao qual você deseja adicionar o serviço e selecione Adicionar Referência de Serviço.

   A caixa de diálogo Adicionar Referência de Serviço é exibida.

2. Clique em Descobrir.

   Todos os serviços (tanto WCF Data Services quanto serviços WCF) na solução atual são adicionados à lista Services.

3. Na lista Serviços , expanda o nó para o serviço que você deseja usar e selecione um conjunto de entidades.

4. Na caixa Namespace , insira o namespace 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) gera e metadados que descrevem o serviço são adicionados ao arquivo app.config .

Para adicionar uma referência a um serviço na solução atual (projetos do .NET Core)

1. No Gerenciador de Soluções, dê um duplo clique ou toque no nó Serviços Conectados.

   A guia Configurar Serviços é aberta.

2. Escolha o Provedor de Referência do Serviço Web do Microsoft WCF.

   A caixa de diálogo Configurar Referência do Serviço Web do WCF é exibida.

3. Clique em Descobrir.

   Todos os serviços (tanto WCF Data Services quanto serviços WCF) na solução atual são adicionados à lista Services.

4. Na lista Serviços , expanda o nó para o serviço que você deseja usar e selecione um conjunto de entidades.

5. Na caixa Namespace , insira o namespace que você deseja usar para a referência.

6. Clique em Concluir para adicionar a referência ao projeto.

   Um cliente de serviço (proxy) gera e metadados que descrevem o serviço são adicionados ao arquivo app.config .

Atualizar uma referência de serviço

O modelo de dados de entidade para um WCF Data Services às vezes é alterado. Quando isso acontece, você deve atualizar a referência de serviço.

Para atualizar uma referência de serviço

Para projetos do .NET Core, use a ferramenta dotnet-svcutil. Consulte dotnet-svcutil para obter instalação e instruções.

Para projetos do .NET Framework:

• No Gerenciador de Soluções, expanda o nó Serviços Conectados , clique com o botão direito do mouse na referência do serviço e selecione Atualizar Referência de Serviço.

  Uma janela de progresso é exibida enquanto a referência é atualizada desde sua localização original, e o cliente de serviço é regenerado para refletir qualquer mudança nos metadados.

Remover uma referência de serviço

Se uma referência de serviço não estiver mais sendo usada, você poderá removê-la da solução.

Para remover uma referência de serviço

• No Gerenciador de Soluções, clique com o botão direito do mouse na referência do serviço e selecione Excluir.

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

  Observação

  Qualquer código que faça referência à referência de serviço deve ser removido manualmente.

Conteúdo relacionado

• Serviços do Windows Communication Foundation e serviços de dados do WCF no Visual Studio