Usar a ferramenta WCF Web Service Reference Provider

Ao longo dos anos, muitos desenvolvedores do Visual Studio aproveitaram a produtividade que a ferramenta Adicionar Referência de Serviço fornecia quando seus projetos do .NET Framework precisavam acessar serviços Web.

A ferramenta WCF Web Service Reference é uma extensão de serviço conectado do Visual Studio que permite conectar seu projeto .NET 5+, .NET Core ou ASP.NET Core a um serviço Web. Ele fornece uma experiência semelhante à funcionalidade Adicionar Referência de Serviço , que é apenas para projetos do .NET Framework. A ferramenta WCF Web Service Reference recupera metadados de um serviço Web na solução atual, em um local de rede ou de um arquivo WSDL e gera um arquivo de origem contendo o código proxy do cliente Windows Communication Foundation (WCF) que seu aplicativo .NET pode usar para acessar o serviço Web.

Importante

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.

Pré-requisitos

• Visual Studio 2017 versão 15.5 ou uma versão posterior

As capturas de tela neste artigo são do Visual Studio 2022.

Como usar a extensão

Nota

A ferramenta WCF Web Service Reference é aplicável somente a projetos C# .NET Core e .NET Standard, incluindo aplicativos Web ASP.NET Core.

Usando o modelo de projeto ASP.NET Core Web Application como exemplo, este artigo o orienta na adição de uma referência de serviço WCF ao projeto.

1. No Gerenciador de Soluções, clique duas vezes no nó Serviços Conectados do projeto. (Para um projeto .NET Core ou .NET Standard, clique com o botão direito do mouse no projeto e selecione Adicionar>Serviço Conectado.)

   A página Serviços Conectados aparece conforme mostrado na imagem a seguir:

   

2. Na página Serviços Conectados, selecione Adicionar Referência de Serviço.

   A página Adicionar referência de serviço é aberta.

3. Selecione WCF Web Service e, em seguida, escolha Next.

   Isso abre o assistente de referência Adicionar novo serviço Web do WCF.

   

4. Selecione um serviço.

   a. Existem várias opções de pesquisa de serviços disponíveis:

   • Para procurar serviços definidos na solução atual, clique no botão Descobrir .
   • Para procurar serviços hospedados em um endereço especificado, insira uma URL de serviço na caixa Endereço e clique no botão Ir .
   • Para selecionar um arquivo WSDL que contenha as informações de metadados do serviço Web, clique no botão Procurar .

   b. Selecione o serviço na lista de resultados da pesquisa na caixa Serviços . Se necessário, insira o namespace para o código gerado na caixa de texto Namespace correspondente.

   c. Clique no botão Avançar para especificar opções de tipo de dados ou opções de cliente. Como alternativa, clique no botão Concluir para usar as opções padrão.

5. A página de opções de tipo de dados permite refinar as definições de configuração de referência de serviço geradas:

   

   Nota

   A opção de caixa de seleção Reutilizar tipos em assemblies referenciados é útil quando os tipos de dados necessários para a geração de código de referência de serviço são definidos em um dos assemblies referenciados do seu projeto. É importante reutilizar esses tipos de dados existentes para evitar conflitos de tipo em tempo de compilação ou problemas de tempo de execução.

   Pode haver um atraso enquanto as informações de tipo são carregadas, dependendo do número de dependências do projeto e outros fatores de desempenho do sistema. O botão Concluir é desativado durante o carregamento, a menos que a caixa de seleção Reutilizar tipos em assemblies referenciados esteja desmarcada.

6. Clique em Concluir quando terminar.

Ao exibir o progresso, a ferramenta:

• Baixa metadados do serviço WCF.
• Gera o código de referência de serviço em um arquivo chamado reference.cs e o adiciona ao seu projeto no nó Serviços Conectados.
• Atualiza o arquivo de projeto (.csproj) com as referências de pacote NuGet necessárias para compilar e executar na plataforma de destino.

Quando esses processos forem concluídos, você poderá criar uma instância do tipo de cliente WCF gerado e invocar as operações de serviço.

Consulte também

• Introdução aos aplicativos do Windows Communication Foundation
• Serviços do Windows Communication Foundation e serviços de dados WCF no Visual Studio
• Recursos suportados pelo WCF no .NET Core

Feedback e perguntas

Se você tiver algum feedback sobre o produto, denuncie-o na Comunidade de desenvolvedores usando a ferramenta Relatar um problema .

Notas de versão

• Consulte as Notas de versão para obter informações atualizadas sobre a versão, incluindo problemas conhecidos.