Compartilhar via

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 forneceu quando seus projetos do .NET Framework precisavam acessar serviços Web.

A ferramenta de Referência do Serviço Web do WCF é 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 é somente para projetos do .NET Framework. A ferramenta de Referência do Serviço Web do WCF recupera metadados de um serviço Web na solução atual, em um local de rede ou em um arquivo WSDL e gera um arquivo de origem que contém o código proxy do cliente WCF (Windows Communication Foundation) que seu aplicativo .NET pode usar para acessar o serviço Web.

Importante

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.

Pré-requisitos

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

Como usar a extensão

Observação

A ferramenta de Referência do Serviço Web do WCF é aplicável somente a projetos C# .NET Core e .NET Standard, incluindo aplicativos Web ASP.NET Core.

Usando o modelo de projeto do aplicativo Web ASP.NET Core como exemplo, este artigo orienta você pela 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 é exibida conforme mostrado na imagem a seguir:

    Guia Serviços Conectados do Visual Studio para .NET Core

  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 o Serviço Web do WCF e escolha Avançar.

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

    Guia Ponto de Extremidade do Serviço do Visual Studio para .NET Core

  4. Selecione um serviço.

    um. 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 contém 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 do 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 configurações de configuração de referência de serviço geradas:

    Guia Opções de tipo de dados do Visual Studio para .NET Core

    Observação

    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 projeto. É importante reutilizar esses tipos de dados existentes para evitar o conflito de tipos durante a 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 de outros fatores de desempenho do sistema. O botão Concluir é desabilitado durante o carregamento, a menos que a caixa de seleção Reutilizar tipos em assemblies referenciados 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 projeto no nó Serviços Conectados .
  • Atualiza o arquivo de projeto (.csproj) com referências de pacote NuGet necessárias para compilar e executar na plataforma de destino.

Janela Progresso do Visual Studio

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

Comentários e perguntas

Se você tiver algum comentário sobre o produto, denuncie-o na Comunidade de Desenvolvedores usando a ferramenta Relatar um problema .

Notas de lançamento

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