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

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

   

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

   Depois de aplicar os filtros de idioma, plataforma e tipo de projeto, selecione o modelo ASP.NET Core Web App e 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 Core 3.1 aparece no campo Target Framework.

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

   • 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 Docker desmarcada e selecione Nenhum para Tipo de autenticação.

   

5. Selecione Criar.

O Visual Studio abre seu novo projeto.

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

   

2. Na janela Criar um novo projeto, selecione C# na lista Idioma. 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.

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 a aba Gerenciador de Soluções para exibir seu conteúdo.

   

2. Expanda a pasta Páginas.

   

3. Selecione o ficheiro Index.cshtml e visualize o ficheiro 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. Exiba o arquivo Index.cshtml.cs no editor de códigos.

   

6. O projeto contém uma pasta wwwroot, que é a pasta 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.

   O projeto também contém arquivos de configuração que gerenciam o aplicativo Web em tempo de execução. O aplicativo padrão de configuração é armazenado em appsettings.json. No entanto, você pode substituir essas configurações usando appsettings.Development.json.

7. 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 criar e executar o aplicativo no modo de depuração. Como alternativa, pressione F5ou vá para Debug>Start Debugging na barra de menus.

   

   Observação

   Se você receber uma mensagem de erro dizendo Não é possível se conectar ao servidor Web 'IIS Express', feche o Visual Studio e, em seguida, 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, em seguida, selecionando a opção Executar como administrador no menu de contexto.

   Você também pode receber uma mensagem perguntando se deseja aceitar um certificado SSL Express do IIS. 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.

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. A página Privacy no navegador renderiza o texto que está configurado no arquivo 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 usando 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 Remover utilizações desnecessárias.

   

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

   

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

7. Em seguida, no método OnGet(), altere o corpo para o seguinte código:

   public void OnGet()
   {
      string dateTime = DateTime.Now.ToShortDateString();
      ViewData["TimeStamp"] = dateTime;
   }
   

8. Observe que um sublinhado ondulado aparece em DateTime. O sublinhado ondulado aparece porque esse tipo não está no escopo.

   

   Abra a barra de ferramentas Lista de Erros para ver os mesmos erros listados. Se não vir a barra de ferramentas Lista de Erros, aceda a VerLista de Erros na barra de menus superior.

   

9. Vamos corrigir esse erro. No editor de códigos, coloque o cursor na linha que contém o erro e, em seguida, selecione a lâmpada Ações Rápidas na margem esquerda. Em seguida, no menu suspenso, selecione usando System; para adicionar esta diretiva ao topo do seu ficheiro e resolver os erros.

   

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

11. Na parte superior do website, selecione Privacidade para ver as suas alterações.

    

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

Alterar a sua página inicial

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

   

   O arquivo Index.cshtml corresponde à sua página Home na aplicação web, que é executado num 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 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 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.

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 a guia Gerenciador de Soluções para exibir seu conteúdo.

   

2. Expanda a pasta Páginas.

   

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

   

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

   

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

   

6. O projeto contém uma pasta wwwroot, que é a raiz do seu sítio web. 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 da aplicação 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 criar 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 Página Inicial e Página de Privacidade na barra de menus.

3. Selecione Privacidade na barra de menus. A página Privacy no navegador renderiza o texto definido no arquivo 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 e aplique. 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() em 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. Na parte superior do site, 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, em seguida, selecione Index.cshtml.

   

   O ficheiro Index.cshtml corresponde à sua página Home na aplicação web, que é executada num navegador 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, podes ver as tuas 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.