Desenvolver com o Visual F# no Visual Studio

Este artigo inclui informações sobre os recursos do Visual Studio para o desenvolvimento do F#.

Instalar o suporte do F#

Para desenvolver com o F# no Visual Studio, primeiro instale a carga de trabalho desenvolvimento para desktop do .NET, caso ainda não tenha feito isso. Instale as cargas de trabalho do Visual Studio por meio do Instalador do Visual Studio, que pode ser aberto pela seleção de Ferramentas>Obter Ferramentas e Recursos.

Recursos de projeto do F#

Vários modelos de projeto e de item estão disponíveis para o F# no Visual Studio. A seguinte imagem mostra alguns dos modelos de projeto do F# para o .NET Core e o .NET Standard:

A seguinte imagem mostra alguns dos modelos de item do F#:

Para obter mais informações sobre os modelos de item para acesso a dados, confira Provedores de tipos F#.

A seguinte tabela resume os recursos nas propriedades do projeto para o F#:

Configuração do projeto	Compatível com o F#?	Observações
Arquivos de recurso	Sim
Configurações de build, depuração e referência	Yes
Multiplataforma	Sim
Ícone e manifesto	Não	Disponível por meio das opções da linha de comando do compilador.
Serviços de Cliente ASP.NET	Não
ClickOnce	Não	Use um projeto de cliente em outra linguagem .NET, se aplicável.
Nomenclatura forte	Não	Disponível por meio das opções da linha de comando do compilador.
Publicação e controle de versão de assembly	Não
Análise de código	Não	As ferramentas de análise de código podem ser executadas manualmente ou como parte de um comando pós-build.
Segurança (alterar níveis de confiança)	Não

Designer de Projeto

O Designer de Projeto consiste no agrupamento de várias páginas de propriedades do projeto por funcionalidade relacionada. As páginas disponíveis para projetos do F# são, principalmente, um subconjunto daquelas disponíveis para outras linguagens e são descritas na tabela a seguir. Links são fornecidos para a página correspondente do Designer de Projeto do C#.

Página do Designer de Projeto	Links relacionados	Descrição
Aplicativo	Página Aplicativo, Designer de Projeto	Permite que você especifique configurações e propriedades no nível do aplicativo, como se estivesse criando uma biblioteca ou um arquivo executável, qual é a versão de destino do .NET para o aplicativo e informações sobre o local de armazenamento dos arquivos de recurso usados pelo aplicativo.
Build	Página de build, Designer de Projeto	Permite que você controle como o código é compilado.
Eventos de compilação	Página Eventos de Build, Designer de Projeto	Permite que você especifique os comandos a serem executados antes ou depois de uma compilação.
Depurar	Página de Depuração, Designer de Projeto	Permite que você controle como o aplicativo é executado durante a depuração. Isso inclui os comandos a serem usados e o diretório inicial do aplicativo, bem como os modos de depuração especiais que você deseja habilitar, como o código nativo e o SQL.
Pacote (somente SDK do .NET)	N/D	Permite que você defina metadados do Pacote NuGet durante a publicação como um pacote NuGet.
Caminhos de Referência	Gerenciar referências em um projeto	Permite que você especifique o local em que pesquisar assemblies dos quais o código depende.
Recursos (somente SDK do .NET)	N/D	Permite que você gere e gerencie um arquivo de recurso padrão.

Configurações específicas do F#

A seguinte tabela resume as configurações específicas do F#:

Página do Designer de Projeto	Configuração	Descrição
Build	Gerar chamadas da parte final	Se ela estiver selecionada, habilitará o uso da instrução MSIL (Microsoft Intermediate Language) da parte final. Isso faz com que o registro de ativação seja reutilizado para funções recursivas da parte final. Equivalente à opção do compilador --tailcalls.
Build	Outros sinalizadores	Permite que você especifique opções adicionais de linha de comando do compilador.

Recursos do editor de código e texto

Há suporte para os seguintes recursos dos editores de código e de texto do Visual Studio no F#:

Recurso	Descrição	Compatível com o F#?
Comentar automaticamente	Permite que você comente ou remova a marca de comentário das seções de código.	Sim
Formatar automaticamente	Reformata o código com recuo e estilo padrão.	Não
Indicadores	Permite que você salve locais no editor.	Sim
Alterar recuo	Recua ou desfaz o recuo das linhas selecionadas.	Sim
Recuo inteligente	Recua e desfaz o recuo do cursor automaticamente, de acordo com as regras de escopo do F#.	Sim
Localizar e substituir texto	Permite que você faça pesquisas em um arquivo, um projeto ou uma solução e, potencialmente, altere o texto.	Sim
Ir para definição da API .NET	Quando o cursor estiver posicionado em uma API .NET, essa configuração mostrará o código gerado com base nos metadados .NET.	Não
Ir para definição de API definida pelo usuário	Quando o cursor estiver em uma entidade de programa definida, essa configuração moverá o cursor para o local no código em que a entidade foi definida.	Sim
Ir para a linha	Permite que você vá para uma linha específica em um arquivo, por número de linha.	Sim
Barras de navegação na parte superior do arquivo	Permite que você vá para locais no código, por exemplo, por nome da função.	Sim
Diretrizes de estrutura de bloco	Mostra as diretrizes que indicam os escopos do F#, que podem ser focalizados para obter uma versão prévia.	Sim
Estrutura de tópicos	Permite que você recolha as seções do código para criar uma exibição mais compacta.	Sim
Tabular	Converte espaços em tabulações.	Sim
Colorização de tipo	Mostra os nomes de tipo definidos em uma cor especial.	Sim
Localização Rápida. Confira Localização Rápida, Janela Localizar e Substituir.	Permite que você faça pesquisas em um arquivo ou um projeto.	Sim
CTRL+clique para Ir para Definição	Permite que você mantenha a tecla Ctrl pressionada e clique em um símbolo do F# para invocar a opção Ir para Definição.	Sim
Ir para definição de QuickInfo	Símbolos clicáveis dentro das dicas de ferramenta que invocam a opção Ir para Definição.	Sim
Ir para Todos	Permite a navegação global de correspondência difusa para todos os constructos do F# por meio de Ctrl+T.	Sim
Renomeação embutida	Renomeia todas as ocorrências de um símbolo embutido.	Sim
Localizar todas as Referências	Localiza todas as ocorrências de um símbolo em uma base de código.	Sim
Simplificar a correção de código do nome	Remove os qualificadores desnecessários para símbolos do F#.	Sim
Remover correção de código de instrução open não utilizada	Remove todas as instruções open desnecessárias de um documento.	Sim
Correção de código do valor não utilizada	Sugere a renomeação de um identificador não utilizado para sublinhado.	Sim

Para obter informações gerais sobre como editar o código no Visual Studio, bem como os recursos do editor de texto, confira Escrever o código no editor.

Recursos do IntelliSense

A seguinte tabela resume os recursos do IntelliSense compatíveis e não compatíveis com o F#:

Recurso	Descrição	Compatível com o F#?
Implementar interfaces automaticamente	Gera os stubs de código para os métodos de interface.	Sim
Snippets de código	Injeta o código de uma biblioteca de constructos de codificação comuns em tópicos.	Não
Completar Palavra	Economiza tempo de digitação preenchendo palavras e nomes conforme você digita.	Sim
Conclusão automática	Quando essa opção está habilitada, faz com que o preenchimento de palavras selecione a primeira correspondência conforme você digita, em vez de esperar que você selecione uma opção ou pressione Ctrl+Espaço.	Sim
Oferecer preenchimento para símbolos em namespaces não abertos	Com o preenchimento automático, um símbolo correspondente que reside em um namespace não aberto é sugerido, oferecendo o preenchimento com a instrução open correspondente, quando selecionado.	Sim
Gerar elementos de código	Permite que você gere o código de stub para uma variedade de constructos.	Não
Listar Membros	Quando você digita o operador de acesso de membro (.), essa opção mostra os membros de um tipo.	Sim
Organizar usings/open	Organiza os namespaces referenciados por instruções using no C# ou diretivas open no F#.	Não
Informações de Parâmetro	Mostra informações úteis sobre os parâmetros conforme você digita uma chamada de função.	Sim
Informação Rápida	Exibe a declaração completa de um identificador no código.	Sim
Preenchimento automático de chaves	Preenche automaticamente constructos de sintaxe semelhantes à chave do F# de maneira transacional.	Sim

Para obter informações gerais sobre o IntelliSense, confira Usar o IntelliSense.

Recursos de depuração

A seguinte tabela resume os recursos disponíveis ao depurar o código F#:

Recurso	Descrição	Compatível com o F#?
Janela Autos	Mostra variáveis automáticas ou temporárias.	Não
Pontos de interrupção	Permite que você pause a execução de código em pontos específicos durante a depuração.	Sim
Pontos de interrupção condicionais	Permite pontos de interrupção que testam uma condição que determina se a execução deve ser colocada em pausa.	Sim
Editar e continuar	Permite que o código seja modificado e compilado durante a depuração de um programa em execução sem interromper e reiniciar o depurador.	Não
Avaliador de expressão	Avalia e executa o código em tempo de execução.	Não, mas o avaliador de expressão C# pode ser usado, embora seja necessário usar a sintaxe C#.
Depuração de histórico	Permite que você intervenha no código executado anteriormente.	Sim
Janela Locais	Mostra as variáveis e os valores definidos localmente.	Sim
Executar até o cursor	Permite que você execute o código até que a linha que contém o cursor seja atingida.	Sim
Depuração Completa	Permite que você avance a execução e passe para qualquer chamada de função.	Sim
Depuração Parcial	Permite que você avance a execução no registro de ativação atual e passe por qualquer chamada de função.	Sim

Para obter informações gerais sobre o depurador do Visual Studio, confira Depuração no Visual Studio.

Ferramentas adicionais

A tabela a seguir resume o suporte para o F# nas ferramentas do Visual Studio.

Ferramenta	Descrição	Compatível com o F#?
Hierarquia de chamadas	Exibe a estrutura aninhada das chamadas de função no código.	Não
Métricas de código	Coleta informações sobre o código, como contagens de linha.	Não
Exibição de Classe	Fornece uma exibição baseada em tipo do código em um projeto.	Não
Janela Lista de Erros	Mostra uma lista de erros no código.	Sim
F# Interativo	Permite que você digite (ou copie e cole) o código F# e execute-o imediatamente, seja qual for o build do projeto. A janela do F# Interativo é um REPL (Loop Ler, Avaliar, Imprimir).	Sim
Pesquisador de Objetos	Permite que você veja os tipos em um assembly.	Os tipos F# exibidos em assemblies compilados não são exibidos exatamente como são criados. Você pode percorrer a representação compilada de tipos F#, mas não pode exibir os tipos como são exibidos no F#.
janela Saída	Exibe a saída de build.	Sim
Análise de desempenho	Fornece ferramentas para avaliar o desempenho do código.	Sim
Janela de Propriedades	Exibe e permite a edição das propriedades do objeto no ambiente de desenvolvimento que tem o foco.	Sim
Gerenciador de Servidores	Fornece maneiras de interagir com uma variedade de recursos do servidor.	Sim
Gerenciador de Soluções	Permite que você veja e gerencie projetos e arquivos.	Sim
Lista de Tarefas	Permite que você gerencie itens de trabalho pertencentes ao código.	Não
Projetos de teste	Fornece recursos que ajudam você a testar o código.	Não
Caixa de Ferramentas	Exibe as guias que contêm objetos arrastáveis como controles e seções de texto ou de código.	Sim

Confira também

• Guia do F# (.NET Framework)
• Introdução ao F# no Visual Studio