Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Para projetos do .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 .NET Core, você pode usar o nó Serviços Conectados no Gerenciador de Soluções para acessar o Microsoft WCF Web Service Reference Provider, que permite gerenciar referências de serviço de dados do Windows Communication Foundation (WCF).
Observação
As instruções neste artigo ilustram a versão mais recente da experiência de desenvolvimento interativo (IDE) disponível no Visual Studio. Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário. Você pode estar usando uma versão diferente do Visual Studio ou configurações de ambiente diferentes. Para obter mais informações, consulte Personalizar o IDE.
Pré-requisitos
As ferramentas WCF não são instaladas com a carga de trabalho .NET; use o Visual Studio Installer para modificar sua instalação. No instalador, escolha Windows Communication Foundation em Componentes individuais. Consulte 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)
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 aparece.
Na caixa Endereço , introduza o URL do serviço e, em seguida, selecione Ir para procurar o serviço. Se o serviço implementar a segurança de nome de utilizador e palavra-passe, poderá ser-lhe pedido um nome de utilizador e uma palavra-passe. Pode também escolher um serviço na sua própria solução. Escolha o botão Descobrir e, em seguida, escolha Serviços na Solução.
Observação
Você só deve fazer referência a 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 Endereço, que armazena as 15 URLs anteriores onde metadados de serviço válidos foram encontrados.
Uma barra de progresso é exibida quando a pesquisa está sendo executada. Você pode parar a pesquisa a qualquer momento clicando em Parar.
Na lista Serviços , expanda o nó do serviço que você deseja usar e selecione um conjunto de entidades.
Na caixa Namespace , insira o namespace que você deseja usar para a referência.
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 .NET Core, incluindo .NET 5 e posteriores)
No Explorador de Soluções, clique duas vezes ou toque no nó Serviços Conectados.
A guia Configurar Serviços é aberta.
Escolha Microsoft WCF Web Service Reference Provider.
A caixa de diálogo Configurar Referência do Serviço Web WCF é exibida.
Na caixa URI , introduza o URL do serviço e, em seguida, selecione Ir para procurar o serviço. Se o serviço implementar a segurança de nome de utilizador e palavra-passe, poderá ser-lhe pedido um nome de utilizador e uma palavra-passe.
Observação
Você só deve fazer referência a 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 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 parar a pesquisa a qualquer momento clicando em Parar.
Na lista Serviços , expanda o nó do serviço que você deseja usar e selecione um conjunto de entidades.
Na caixa Namespace , insira o namespace que você deseja usar para a referência.
Clique em Concluir 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)
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 aparece.
Clique em Descobrir.
Todos os serviços (WCF Data Services e WCF services) na solução atual são adicionados à lista Serviços .
Na lista Serviços , expanda o nó do serviço que você deseja usar e selecione um conjunto de entidades.
Na caixa Namespace , insira o namespace que você deseja usar para a referência.
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 .NET Core)
No Explorador de Soluções, clique duas vezes ou toque no nó Serviços Conectados.
A guia Configurar Serviços é aberta.
Escolha Microsoft WCF Web Service Reference Provider.
A caixa de diálogo Configurar Referência do Serviço Web WCF é exibida.
Clique em Descobrir.
Todos os serviços (WCF Data Services e WCF services) na solução atual são adicionados à lista Serviços .
Na lista Serviços , expanda o nó do serviço que você deseja usar e selecione um conjunto de entidades.
Na caixa Namespace , insira o namespace que você deseja usar para a referência.
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 muda. Quando isso acontece, você deve atualizar a referência do serviço.
Para atualizar uma referência de serviço
Para projetos .NET Core, use a ferramenta dotnet-svcutil. Consulte dotnet-svcutil para obter instruções de instalação.
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 de serviço e selecione 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 do 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 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 de 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 deapp.config .
Observação
Qualquer código que faça referência à referência de serviço deve ser removido manualmente.