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

Neste tutorial para desenvolvimento em C# com ASP.NET Core, você cria um aplicativo Web C# ASP.NET Core 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
• Explore os recursos do IDE
• Executar o aplicativo Web

Pré-requisitos

Para concluir este tutorial, você precisa:

• Visual Studio instalado. 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, consulte atualizações do Visual Studio.
• O ASP.NET e desenvolvimento web carga de trabalho instalada. Para verificar ou instalar essa carga de trabalho no Visual Studio, selecione Ferramentas >Obter Ferramentas e Recursos. Para obter mais informações, consulte Alterar as cargas de trabalho ou os componentes individuais.

Criar um projeto

Primeiro, você cria um projeto ASP.NET Core. O tipo de projeto vem com todos os arquivos de modelo que você precisa para construir um site totalmente funcional.

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

   

2. Na janela Criar um novo projeto, selecione C# da lista de Idiomas. Em seguida, selecione Windows na lista Todas as plataformas e Web na lista Todos os tipos de projeto.

   Depois de aplicar os filtros de idioma, plataforma e tipo de projeto, selecione o modelo ASP.NET Core Web App (Razor Pages) e, em seguida, selecione Avançar.

   

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

   

4. Na janela informações adicionais, verifique se do .NET 8.0 aparece no campo do Target Framework.

   Nessa janela, você pode habilitar o suporte a contêineres e adicionar suporte à autenticação. O menu suspenso para Tipo de Autenticação tem as seguintes quatro opções:

   • Nenhum: Sem 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: Esta opção usa o Microsoft Entra ID ou o Microsoft 365 para autenticação.
   • Windows: Adequado para aplicações de intranet.

   Deixe a caixa Ativar suporte a contentor desmarcada e selecione Nenhum para Tipo de autenticação.

   

5. Selecione Criar.

O Visual Studio abre seu novo projeto.

Sobre a sua solução

Esta solução segue o padrão de design Razor Page. É diferente do padrão de design Modelo-View-Controller (MVC) , pois é simplificado para incluir o código do modelo e do controlador na própria Razor Page.

Faça um tour pela sua solução

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

   

2. Expanda a pasta Páginas.

   

3. Selecione o ficheiro Index.cshtml e veja 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 Explorador de Soluções e selecione o arquivo Index.cshtml.cs.

   

5. Exiba o arquivo Index.cshtml.cs no editor de códigos.

   

6. O projeto inclui uma pasta wwwroot, que serve como a raiz do seu site. Expanda a pasta para exibir seu conteúdo.

   

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

7. O projeto também contém arquivos de configuração que gerenciam o aplicativo Web em tempo de execução. A configuração do 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 https para compilar e executar a aplicação no modo de depuração. Como alternativa, pressione F5ou vá para Debug>Start Debugging na barra de menus.

   

   Observação

   Você também pode receber uma mensagem perguntando se deseja aceitar um certificado SSL ASP.NET Core. Para exibir o código em um navegador da Web, selecione Sime, em seguida, selecione Sim se receber uma mensagem de aviso de segurança de acompanhamento. Saiba mais sobre como aplicar SSL no ASP.NET Core.

2. O Visual Studio inicia uma janela do navegador. Em seguida, deverá ver as páginas Página Inicial e Privacidade na barra de menus.

3. Selecione Privacidade na barra de menus. No navegador, a página de Privacidade renderiza o texto definido no ficheiro Privacy.cshtml .

   

4. Retorne ao Visual Studio e pressione Shift+F5 para parar a depuração. Esta 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 seu site e substitua-a 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:

   Passe o mouse ou selecione uma diretiva using acinzentada. Uma Ações Rápidas lâmpada aparece abaixo do cursor ou na margem esquerda. Selecione a lâmpada e, em seguida, selecione a seta de expansão ao lado de Remover usos desnecessários.

   

   Agora, selecione Visualizar alterações para ver o que muda.

   

   Selecione Aplicar. 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 região para a data. O segundo argumento determina, entre outras coisas, a linguagem de quaisquer palavras na data e o tipo de separadores usados.

   Altere o corpo do método OnGet() no arquivo Privacy.cshtml.cs para o seguinte código:

   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. No topo do website, selecione Privacidade para ver as suas alterações.

    

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

Alterar a sua página inicial

1. No Explorador de Soluções, expanda a pasta Páginas e selecione Index.cshtml.

   

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

   

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

   

2. Substitua o texto Welcome por Hello World!

   

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

   

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

   

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

Próximos passos

Parabéns por concluir este tutorial! Esperamos que você tenha gostado de aprender sobre C#, 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 seguinte tutorial:

Criar um aplicativo Web Razor Pages com ASP.NET Core

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

Ferramentas de Contêiner no Visual Studio

Ligações úteis

• Publicar seu aplicativo Web no Serviço de Aplicativo do Azure usando o Visual Studio
• Personalizar o IDE e o Editor do Visual Studio