Tutorial: Criar um serviço Web ASP.NET Core no F#

O IDE (Ambiente de Desenvolvimento Integrado) do Visual Studio oferece suporte ao F# para vários tipos de produto. É possível criar facilmente um aplicativo de serviços Web completo.

Para obter mais informações sobre codificação em F#, consulte O que é F#. Para criar um aplicativo de console Olá, Mundo, consulte Introdução ao F# no Visual Studio.

Neste tutorial, você aprenderá como:

  • Crie um serviço Web ASP.NET Core no F#.
  • Adicione conteúdo ao membro HttpGet em F#.
  • Crie e execute o programa.

Pré-requisitos

Você precisa do Visual Studio para concluir este tutorial. Visite a página de downloads do Visual Studio para obter uma versão gratuita.

Você precisa do Visual Studio para concluir este tutorial. Visite a página de downloads do Visual Studio para obter uma versão gratuita.

Verifique se você tem os componentes necessários instalados:

  1. Selecione o ícone Iniciar Windows e digite Instalador do Visual Studio.

  2. Selecione Modificar para visualizar as cargas de trabalho instaladas.

  3. Verifique se ASP.NET e desenvolvimento para a Web está selecionado ou adicione-o.

    Screenshot shows modifying a workload in Visual Studio Installer.

  4. Se você fez alterações, selecione Modificar para instalar os componentes.

Crie um serviço Web ASP.NET Core

Nesta seção, você cria um projeto de API Web do ASP.NET Core. O tipo de projeto vem com arquivos de modelo que constituem um serviço Web funcional, mesmo sem adicionar nada.

  1. Inicie o Visual Studio.

  2. Na janela Iniciar, selecione Criar um novo projeto.

  3. Na página Criar um novo projeto, insira F# web na caixa de pesquisa. Selecione o modelo do projeto da API Web do ASP.NET Core e, em seguida, Avançar.

  4. Na caixa de diálogo Configurar seu novo projeto, em Nome do projeto, insira FSharpTutorial.

  5. Na caixa de diálogo Informações adicionais, aceite a versão padrão do Framework.

    Quando você seleciona Criar, o Visual Studio cria o novo projeto F#. É possível visualizar os componentes do projeto na janela Gerenciador de Soluções. O Visual Studio apresenta uma página Visão geral.

  6. Na barra de ferramentas Gerenciador de Soluções, expanda a pasta Controladores e, em seguida, escolha WeatherForecastController.fs para abrir o arquivo de código no editor.

    Screenshot showing the Solution Explorer with the Weather Forecast Controller expanded in an F# Web API project.

  7. Em seguida, modifique o membro Get() para que tenha o seguinte código:

    [<HttpGet>]
    member this.Get() =
        let values = [|"Hello"; "World"; "First F#/ASP.NET Core web API!"|]
        ActionResult<string[]>(values)
    

    Esse código contém uma matriz F# de valores associados ao nome values. Ele passa os valores para a estrutura ASP.NET Core model-view-controller como um ActionResult. O ASP.NET Core cuida do resto para você.

  8. Selecione a tecla F5 para executar o programa. Uma janela do navegador é aberta para exibir sua mensagem de Olá, Mundo.

Observação

Se você receber uma mensagem perguntando se deseja aceitar um certificado SSL Express do IIS, escolha Sim para exibir o código em um navegador da Web e escolha Sim se receber uma mensagem de aviso de segurança de acompanhamento.

Próximas etapas

Caso ainda não tenha feito, consulte o Tour do F#. Este tour descreve os principais recursos da linguagem F#. Ele fornece uma visão geral de alguns dos recursos de F# e códigos de exemplo que podem ser executados.

Confira também