Usar a ferramenta WCF Web Service Reference Provider

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

A ferramenta WCF Web Service Reference é uma extensão de serviço conectada 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 .NET Framework. Essa 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 compatível com o .NET Core que contém o código de proxy de cliente do WCF (Windows Communication Foundation) que o seu aplicativo .NET pode usar para acessar esse serviço Web.

Importante

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.

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

Observação

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

Ao usar o modelo de projeto Aplicativo Web ASP.NET Core como um exemplo, este artigo o orienta na adição de uma referência de serviço WCF ao projeto:

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

   A página Serviços Conectados é exibida, 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 Serviço Web do WCF e escolha Avançar.

   Isso apresenta o assistente Adicionar nova referência de serviço ao WCF Web Service.

   

4. Selecione um serviço.

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

   • Para pesquisar serviços definidos na solução atual, clique no botão Descobrir.
   • Para pesquisar 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 Opções de tipo de dados permite que você refine as definições de configuração de referência do serviço gerado:

   

   Observação

   A opção da caixa de seleção Usar novamente os tipos em assemblies consultados é útil quando os tipos de dados necessários para a geração de código da 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 problemas de conflito de tipo de tempo de compilação ou problemas de runtime.

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

6. Clique em Concluir quando terminar.

Enquanto exibe o andamento, 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 do WCF gerado e invocar as operações de serviço.

Confira também

• Comece com aplicativos do Windows Communication Foundation
• Serviços do Windows Communication Foundation e WCF Data Services no Visual Studio
• Recursos com suporte do WCF no .NET Core

Perguntas e comentários

Se você tiver algum comentário do produto, encaminhe-o para a Developer Community usando a ferramenta Relatar um problema.

Notas de versão

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