Usar a ferramenta WCF Web Service Reference ProviderUse the WCF Web Service Reference Provider Tool

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.Over the years, many Visual Studio developers have enjoyed the productivity that the Add Service Reference tool provided when their .NET Framework projects needed to access web services. A ferramenta WCF Web Service Reference é uma extensão de serviço conectado do Visual Studio que fornece uma experiência semelhante à funcionalidade Adicionar Referência de Serviço para projetos do .NET Core e ASP.NET Core.The WCF Web Service Reference tool is a Visual Studio connected service extension that provides an experience like the Add Service Reference functionality for .NET Core and ASP.NET Core projects. Essa ferramenta 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 você pode usar para acessar esse serviço Web.This tool retrieves metadata from a web service in the current solution, on a network location, or from a WSDL file, and generates a .NET Core compatible source file containing Windows Communication Foundation (WCF) client proxy code that you can use to access the web service.

Importante

Você só deve fazer referência a serviços de uma fonte confiável.You should only reference services from a trusted source. A adição de referências de uma fonte não confiável pode comprometer a segurança.Adding references from an untrusted source may compromise security.

PrerequisitesPrerequisites

Como usar a extensãoHow to use the extension

Observação

A opção WCF Web Service Reference é aplicável a projetos criados com o uso dos seguintes modelos de projeto:The WCF Web Service Reference option is applicable to projects created using the following project templates:

  • Visual C# > .NET CoreVisual C# > .NET Core
  • Visual C# > .NET StandardVisual C# > .NET Standard
  • Visual C# > Web > Aplicativo Web ASP.NET CoreVisual C# > Web > ASP.NET Core Web Application

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:Using the ASP.NET Core Web Application project template as an example, this article walks you through adding a WCF service reference to the project:

  1. No Gerenciador de Soluções, clique duas vezes no nó Serviços Conectados do projeto (para um projeto do .NET Core ou .NET Standard, essa opção está disponível quando você clica com o botão direito do mouse no nó Dependências do projeto no Gerenciador de Soluções).In Solution Explorer, double-click the Connected Services node of the project (for a .NET Core or .NET Standard project this option is available when you right-click on the Dependencies node of the project in Solution Explorer).

    A página Serviços Conectados é exibida, conforme mostrado na imagem a seguir:The Connected Services page appears as shown in the following image:

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

  2. Na página Serviços Conectados, clique em Microsoft WCF Web Service Reference Provider.On the Connected Services page, click Microsoft WCF Web Service Reference Provider. Isso apresenta o assistente Configurar a WCF Web Service Reference:This brings up the Configure WCF Web Service Reference wizard:

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

  3. Selecione um serviço.Select a service.

    3a.3a. Há várias opções de pesquisa de serviços disponíveis no assistente Configurar a WCF Web Service Reference:There are several services search options available within the Configure WCF Web Service Reference wizard:

    • Para pesquisar serviços definidos na solução atual, clique no botão Descobrir.To search for services defined in the current solution, click the Discover button.
    • 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.To search for services hosted at a specified address, enter a service URL in the Address box and click the Go button.
    • Para selecionar um arquivo WSDL que contenha as informações de metadados do serviço Web, clique no botão Procurar.To select a WSDL file that contains the web service metadata information, click the Browse button.

    3b.3b. Selecione o serviço na lista de resultados da pesquisa na caixa Serviços.Select the service from the search results list in the Services box. Se necessário, insira o namespace para o código gerado na caixa de texto Namespace correspondente.If needed, enter the namespace for the generated code in the corresponding Namespace text box.

    3c.3c. Clique no botão Avançar para abrir as páginas Opções de Tipo de Dados e Opções do Cliente.Click the Next button to open the Data Type Options and the Client Options pages. Como alternativa, clique no botão Concluir para usar as opções padrão.Alternatively, click the Finish button to use the default options.

  4. O formulário Opções de Tipo de Dados permite que você refine as definições de configuração de referência do serviço gerado:The Data Type Options form enables you to refine the generated service reference configuration settings:

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

    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.The Reuse types in referenced assemblies check box option is useful when data types needed for service reference code generation are defined in one of your project's referenced assemblies. É importante reutilizar esses tipos de dados existentes para evitar problemas de conflito de tipo de tempo de compilação ou problemas de tempo de execução.It's important to reuse those existing data types to avoid compile-time type clash or runtime issues.

    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.There may be a delay while type information is loaded, depending on the number of project dependencies and other system performance factors. 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.The Finish button is disabled during loading unless the Reuse types in referenced assemblies check box is unchecked.

  5. Clique em Concluir quando terminar.Click Finish when you are done.

Enquanto exibe o andamento, a ferramenta:While displaying progress, the tool:

  • Baixa metadados do serviço WCF.Downloads metadata from the WCF service.
  • 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.Generates the service reference code in a file named reference.cs, and adds it to your project under the Connected Services node.
  • Atualiza o arquivo de projeto (.csproj) com as referências de pacote NuGet necessárias para compilar e executar na plataforma de destino.Updates the project file (.csproj) with NuGet package references required to compile and run on the target platform.

Janela Progresso do Studio Visual

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.When these processes complete, you can create an instance of the generated WCF client type and invoke the service operations.

Consulte tambémSee also

Perguntas e comentáriosFeedback & questions

Se você tiver dúvidas ou comentários, denuncie-o na comunidade de desenvolvedores usando o relatório uma ferramenta problemática .If you have any questions or feedback, report it at Developer Community using the Report a problem tool.

Notas de VersãoRelease notes

  • Consulte as Notas de versão para obter informações de versão atualizadas, incluindo problemas conhecidos.Refer to the Release notes for updated release information, including known issues.