Tutorial: Introdução ao C# e ao ASP.NET Core no Visual Studio

Neste tutorial para desenvolvimento em C# com o ASP.NET Core, você criará um aplicativo Web do ASP.NET Core em C# no Visual Studio.

Este tutorial mostra como:

• Criar um projeto do Visual Studio
• Criar um aplicativo Web C# ASP.NET Core
• Fazer alterações no aplicativo Web
• Explorar recursos do IDE
• Execute o aplicativo Web

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.

• Para obter mais informações sobre como atualizar para a versão mais recente do Visual Studio, confira Atualizações do Visual Studio.

• Para personalizar sua experiência do Visual Studio, confira Personalizar o IDE e o Editor do Visual Studio.

Criar um projeto

Primeiro, você cria um projeto do ASP.NET Core. O tipo de projeto vem com todos os arquivos de modelo necessários para criar um site totalmente funcional.

1. Na janela inicial, selecione Criar um novo projeto.

   

2. Na janela Criar um novo projeto, selecione C# na lista Linguagem. Em seguida, selecione Windows na lista de plataformas e Web na lista de tipos de projeto.

   Depois de aplicar os filtros de linguagem, plataforma e tipo de projeto, selecione o modelo Aplicativo Web ASP.NET Core e, em seguida, Avançar.

   

   Observação

   Se não vir o modelo Aplicativo Web ASP.NET Core, você poderá instalá-lo da janela Criar um novo projeto.

   Na mensagem Não encontrou o que você procura? na parte inferior da lista de modelos, selecione o link Instalar mais ferramentas e recursos.

   

   No Instalador do Visual Studio, selecione a carga de trabalho de ASP.NET e desenvolvimento na Web.

   

   Selecione o botão Modificar no Instalador do Visual Studio. Pode ser necessário salvar o trabalho. Nesse caso, execute essa ação. Selecione Continuar para instalar a carga de trabalho.

   Retorne à etapa 2 neste procedimento "Criar um projeto".

3. Na janela Configurar seu novo projeto, digite MyCoreApp no campo Nome do projeto. Em seguida, selecione Avançar.

   

4. Na janela Informações adicionais, verifique se o .NET 8.0 aparece no campo Estrutura de destino.

   Nessa janela, você pode habilitar o suporte ao Docker e adicionar suporte à autenticação. O menu suspenso do Tipo de Autenticação tem as quatro opções a seguir:

   • Nenhum: nenhuma autenticação.
   • Contas individuais: essas autenticações são armazenadas em um banco de dados local ou baseado no Azure.
   • Plataforma de identidade da Microsoft: essa opção usa o Microsoft Entra ID ou o Microsoft 365 para autenticação.
   • Windows: adequado para aplicativos de intranet.

   Deixe a caixa Habilitar Docker desmarcada e selecione Nenhum em Tipo de Autenticação.

   

5. Selecione Criar.

O Visual Studio abre seu novo projeto.

Sobre sua solução

Esta solução segue o padrão de design da Página do Razor. Ele é diferente do padrão de design Model-View-Controller (MVC) que é simplificado para incluir o código do modelo e do controlador na própria página do Razor.

Fazer tour da sua solução

1. O modelo de projeto cria uma solução com um único projeto do ASP.NET Core chamado MyCoreApp. Selecione a guia Gerenciador de Soluções para exibir seu conteúdo.

   

2. Expanda a pasta Páginas.

   

3. Selecione o arquivo Index.cshtml e exiba no editor de código.

   

4. Cada arquivo .cshtml tem um arquivo de código associado. Para abrir o arquivo de código no editor, expanda o nó Index.cshtml no Gerenciador de Soluções e selecione o arquivo Index.cshtml.cs.

   

5. Visualize o arquivo Index.cshtml.cs no editor de código.

   

6. O projeto contém uma pasta wwwroot, que é a raiz do seu site. Expanda a pasta para exibir seu conteúdo.

   

   Você pode colocar conteúdo de site estático, como CSS, imagens e bibliotecas JavaScript diretamente nos caminhos onde deseja.

7. O projeto também contém os arquivos de configuração que gerenciam o aplicativo web no tempo de execução. A configuração de aplicativo padrão é armazenada em appsettings.json. No entanto, você pode substituir essas configurações usando appsettings.Development.json. Expanda o arquivo appsettings.json para exibir o arquivo appsettings.Development.json.

   

Executar, depurar e fazer alterações

1. Na barra de ferramentas, selecione o botão IIS Express para compilar e executar o aplicativo no modo de depuração. Como alternativa, pressione F5 ou vá para Depurar>Iniciar Depuração na barra de menus.

   

   Observação

   Se você receber uma mensagem de erro informando Não é possível se conectar ao servidor Web 'IIS Express', feche o Visual Studio e reinicie o programa como administrador. Você pode fazer essa tarefa clicando com o botão direito do mouse no ícone do Visual Studio no Menu Iniciar e selecionando a opção Executar como administrador no menu de contexto.

   Você também pode obter uma mensagem perguntando se deseja aceitar um certificado SSL do IIS Express. Para exibir o código em um navegador da Web, selecione Sim e, em seguida, Sim se você receber uma mensagem de aviso de segurança de acompanhamento.

2. O Visual Studio abre uma janela do navegador. Em seguida, você deve ver a Página Inicial e a página Privacidade na barra de menus.

3. Selecione Privacidade na barra de menus. A página Privacidade no navegador renderiza o texto definido no arquivo Privacy.cshtml.

   

4. Retorne ao Visual Studio e pressione Shift+F5 para interromper a depuração. Essa ação fecha o projeto na janela do navegador.

5. No Visual Studio, abra Privacy.cshtml para edição. Em seguida, exclua a frase Use esta página para detalhar a política de privacidade do site e substitua por Esta página está em construção a partir de @ViewData["TimeStamp"].

   

6. Agora, vamos fazer uma alteração de código. Selecione Privacy.cshtml.cs. Em seguida, limpe as diretivas using na parte superior do arquivo selecionando o seguinte atalho:

   Diretiva mouseover or select a greyed out using. Uma lâmpada de Ações Rápidas aparece abaixo do cursor ou na margem esquerda. Selecione o ícone de lâmpada e a seta de expansão ao lado de Remover usos desnecessários.

   

   Agora, selecione Pré-visualizar alterações para ver as alterações.

   

   Escolha Aplicar. O Visual Studio exclui as diretivas using desnecessárias do arquivo.

7. Em seguida, crie uma cadeia de caracteres para a data atual formatada para sua cultura ou região usando o método DateTime.ToString.

   • O primeiro argumento para o método especifica como a data deve ser exibida. Este exemplo usa o especificador de formato (d) que indica o formato de data abreviada.
   • O segundo argumento é o objeto CultureInfo que especifica a cultura ou a região da data. O segundo argumento determina, entre outras coisas, o idioma de qualquer palavra na data e o tipo de separadores usados.

   Altere o corpo do método OnGet() para o código a seguir:

   public void OnGet()
   {
      string dateTime = DateTime.Now.ToString("d", new CultureInfo("en-US"));
      ViewData["TimeStamp"] = dateTime;
   }
   

8. Observe que a seguinte diretiva using é adicionada automaticamente à parte superior do arquivo:

   using System.Globalization;
   

   System.Globalization contém a classe CultureInfo.

9. Pressione F5 para abrir seu projeto no navegador da Web.

10. Na parte superior do site, selecione Privacidade para ver as alterações.

    

11. Feche o navegador da Web, pressione Shift+F5 para interromper a depuração.

Alterar a página inicial

1. No Gerenciador de Soluções, expanda a pasta Páginas e, em seguida, selecione index.cshtml.

   

   O arquivo Index.cshtml corresponde à página Inicial no aplicativo Web, que é executado em um navegador da Web.

   

   No editor de código, você verá o código HTML para o texto que aparece na página Página inicial.

   

2. Substitua o texto Bem-vindo por Olá, Mundo.

   

3. Selecione IIS Express ou pressione Ctrl+F5 para executar o aplicativo e abri-lo em um navegador da Web.

   

4. No navegador da Web, você verá suas novas alterações na página Página inicial.

   

5. Feche o navegador da Web, pressione Shift+F5 para interromper a depuração e salve seu projeto. Agora você pode fechar o Visual Studio.

Próximas etapas

Parabéns por concluir este tutorial. Esperamos que você tenha gostado de aprender sobre o C#, o ASP.NET Core e o IDE do Visual Studio. Para saber mais sobre como criar um aplicativo Web ou site com C# e ASP.NET, continue com o tutorial a seguir:

Criar um aplicativo Web Páginas Razor com o ASP.NET Core

Ou saiba como colocar seu aplicativo Web em contêineres com o Docker:

Ferramentas de Contêiner no Visual Studio

Confira também

Publicar seu aplicativo Web no Serviço de Aplicativo do Azure usando o Visual Studio