Adicionar, atualizar ou remover uma referência do WCF Data Service

Para projetos .NET Framework, a referência de serviço permite que um projeto acesse um ou mais WCF Data Services. Use a caixa de diálogo Adicionar Referência de Serviço para procurar WCF Data Services 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 do Microsoft WCF Web Service Reference, que permite gerenciar referências de serviço de dados do WCF (Windows Communication Foundation).

Observação

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

Pré-requisitos

As ferramentas do WCF não sã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. Em 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 clique em 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 clique em Ir para procurar o serviço. Se o serviço implementar segurança de nome de usuário e senha, esses dados poderão ser solicitados. 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 fazer referência a serviços de uma fonte confiável. A adição de referências de uma fonte não confiável pode comprometer a segurança.

   Você também pode selecionar a URL na lista Endereço, 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, digite o namespace que 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 os 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 o .NET 5 e versões posteriores)

1. No Gerenciador de Soluções, clique duas vezes no nó Serviços Conectados.

   A guia Configurar Serviços é aberta.

2. Escolha Provedor do Microsoft WCF Web Service Reference.

   A caixa de diálogo Configurar WCF Web Service Reference é exibida.

   

3. Na caixa URI, insira a URL do serviço e clique em Ir para procurar o serviço. Se o serviço implementar segurança de nome de usuário e senha, esses dados poderão ser solicitados.

   Observação

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

   Você também pode selecionar a URL na lista URI, 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.

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, digite o namespace que deseja usar para a referência.

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

   Um cliente de serviço (proxy) é gerado e os 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. Em 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 clique em 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 (WCF Data Services e serviços WCF) na solução atual são adicionados à lista Serviços.

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, digite o namespace que 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 os 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, clique duas vezes no nó Serviços Conectados.

   A guia Configurar Serviços é aberta.

2. Escolha Provedor do Microsoft WCF Web Service Reference.

   A caixa de diálogo Configurar WCF Web Service Reference é exibida.

3. Clique em Descobrir.

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

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, digite o namespace que deseja usar para a referência.

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

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

Atualizar uma referência de serviço

Às vezes, o Modelo de Dados de Entidade para um WCF Data Services é alterado. Quando isso acontece, você deve atualizar a referência de serviço.

Atualizar uma referência de serviço

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

Para projetos do .NET Framework:

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

  Uma caixa de diálogo de progresso é exibida enquanto a referência é atualizada de seu local original, e o cliente de serviço é regenerado para refletir quaisquer alterações 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 de sua solução.

Remover uma referência de serviço

• Em Gerenciador de Soluções, clique com o botão direito do mouse na referência de serviço e clique em 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 WCF Data Services no Visual Studio