Partilhar via

Tutorial: Introdução ao Razor Pages no ASP.NET Core

  • Artigo

Observação

Esta não é a versão mais recente deste artigo. Para a versão atual, consulte a versão .NET 9 deste artigo.

Advertência

Esta versão do ASP.NET Core não é mais suportada. Para obter mais informações, consulte a Política de suporte do .NET e .NET Core. Para a versão atual, consulte a versão .NET 9 deste artigo.

Importante

Estas informações referem-se a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, em relação às informações fornecidas aqui.

Para a versão atual, consulte a versão .NET 9 deste artigo.

Por Rick Anderson

Este é o primeiro tutorial de uma série que ensina os conceitos básicos da criação de um aplicativo Web ASP.NET Core Razor Pages.

Para obter uma introdução mais avançada destinada a desenvolvedores que estão familiarizados com controladores e modos de exibição, consulte Introdução ao Razor Pages. Para uma introdução em vídeo, consulte Entity Framework Core for Beginners.

Se és novo no desenvolvimento de ASP.NET Core e não tens a certeza de qual solução de interface web do ASP.NET Core melhor atenderá às tuas necessidades, consulta Escolher uma interface de utilizador do ASP.NET Core.

No final deste tutorial, você terá um aplicativo Web Razor Pages que gerencia um banco de dados de filmes.

Home ou Página de índice

Pré-requisitos

Criar uma aplicação Web Razor Páginas

  • Inicie o Visual Studio e selecione Novo projeto.

  • Na caixa de diálogo Criar um novo projeto , selecione ASP.NET Core Web App ( Pages)Next.

  • Na caixa de diálogo Configurar o seu novo projeto, introduza RazorPagesMovie para Nome do Projeto. É importante nomear o projeto RazorPagesMovie, incluindo o uso correto de maiúsculas, para que os namespaces correspondam quando copiares e colares exemplos de código.

  • Selecione Avançar.

  • No Informações adicionais caixa de diálogo:

    • Selecione .NET 9.0.
    • Verificar: Não use instruções de nível superior está desmarcada.

  • Selecione Criar.

    Informações adicionais

    O seguinte projeto inicial é criado:

    Gerenciador de Soluções

Para abordagens alternativas para criar o projeto, consulte Criar um novo projeto no Visual Studio.

Executar o aplicativo

Selecione RazorPagesMovie no Gerenciador de Soluções e pressione Ctrl+F5 para executar o aplicativo sem o depurador.

Visual Studio exibe a seguinte caixa de diálogo quando um projeto ainda não está configurado para usar SSL:

Este projeto está configurado para usar SSL. Para evitar avisos SSL no navegador, você pode optar por confiar no certificado autoassinado que o IIS Express gerou. Gostaria de confiar no certificado SSL do IIS Express?

Selecione Sim se confiar no certificado SSL do IIS Express.

A seguinte caixa de diálogo é exibida:

Caixa de diálogo de aviso de segurança

Selecione Sim se concordar em confiar no certificado de desenvolvimento.

Para obter informações sobre como confiar no navegador Firefox, consulte o erro de certificado SEC_ERROR_INADEQUATE_KEY_USAGE do Firefox .

Visual Studio:

  • Executa o aplicativo, que inicia o servidor Kestrel.
  • Inicia o navegador padrão em https://localhost:<port>, que exibe a interface do usuário do aplicativo. <port> é a porta aleatória atribuída quando o aplicativo foi criado.

Feche a janela do navegador.

Examinar os arquivos do projeto

As seções a seguir contêm uma visão geral das principais pastas e arquivos do projeto com os quais você trabalhará em tutoriais posteriores.

Pasta de Páginas

Contém Razor páginas e ficheiros de suporte. Cada página Razor é um par de ficheiros:

  • Um arquivo .cshtml que tem marcação HTML com código C# usando sintaxe Razor.
  • Um arquivo .cshtml.cs que tem código C# que manipula eventos de página.

Os arquivos de suporte têm nomes que começam com um sublinhado. Por exemplo, o arquivo _Layout.cshtml configura elementos da interface do usuário comuns a todas as páginas. _Layout.cshtml configura o menu de navegação na parte superior da página e o aviso de direitos autorais na parte inferior da página. Para obter mais informações, consulte layout no ASP.NET Core.

pasta wwwroot

Contém ativos estáticos, como arquivos HTML, JavaScript e CSS. Para obter mais informações, consulte ficheiros estáticos no ASP.NET Core.

appsettings.json

Contém dados de configuração, como cadeias de conexão. Para obter mais informações, consulte Configuração no ASP.NET Core.

Program.cs

Contém o seguinte código:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages();

app.Run();

As seguintes linhas de código neste ficheiro criam um WebApplicationBuilder com predefinições pré-configuradas, adicionam suporte para Razor Pages ao contentor de Injeção de Dependência (DI)e constroem a aplicação.

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

A página de exceção do desenvolvedor é habilitada por padrão e fornece informações úteis sobre exceções. Os aplicativos de produção não devem ser executados no modo de desenvolvimento porque a página de exceção do desenvolvedor pode vazar informações confidenciais.

O código abaixo define o ponto de extremidade de exceção como /Error e ativa o protocolo HTTP Strict Transport Security (HSTS) quando o aplicativo não está em execução no modo de desenvolvimento.

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

Por exemplo, o código anterior é executado quando o aplicativo está no modo de produção ou teste. Para obter mais informações, consulte Usar vários ambientes no ASP.NET Core.

O código a seguir habilita vários middlewares:

  • app.UseHttpsRedirection(); : Redireciona solicitações HTTP para HTTPS.
  • app.UseRouting(); : Adiciona correspondência de rota ao pipeline de middleware. Para obter mais informações, consulte Roteamento no ASP.NET Core.
  • app.UseAuthorization(); : Autoriza um usuário a acessar recursos seguros. Este aplicativo não usa autorização, portanto, esta linha pode ser removida.
  • app.MapRazorPages();: Configura o roteamento de endpoint para Razor Páginas.
  • app.MapStaticAssets(); : otimize a entrega de ativos estáticos em um aplicativo, como HTML, CSS, imagens e JavaScript. Para obter mais informações, consulte O que há de novo no ASP.NET Core 9.0.
  • app.Run(); : Executa o aplicativo.

Solução de problemas com o exemplo concluído

Se você encontrar um problema que não pode resolver, compare seu código com o projeto concluído. Ver ou transferir o projeto concluído (como transferir).

Próximos passos

Próximo: Adicionar um modelo

Este é o primeiro tutorial de uma série que ensina os conceitos básicos da criação de um aplicativo Web ASP.NET Core Razor Pages.

Para obter uma introdução mais avançada destinada a desenvolvedores que estão familiarizados com controladores e modos de exibição, consulte Introdução ao Razor Pages. Para uma introdução em vídeo, consulte Entity Framework Core for Beginners.

Se estiver a começar no desenvolvimento do ASP.NET Core e não tiver a certeza de qual solução de IU web do ASP.NET Core melhor se adequa às suas necessidades, consulte Escolha uma IU do ASP.NET Core.

No final deste tutorial, você terá um aplicativo Web Razor Pages que gerencia um banco de dados de filmes.

Home ou Página de índice

Pré-requisitos

  • Visual Studio 2022 com a carga de trabalho de ASP.NET e desenvolvimento web.

    cargas de trabalho do instalador do VS22

Criar uma aplicação web Razor Pages

  • Inicie o Visual Studio e selecione Novo projeto.

  • Na caixa de diálogo Criar um novo projeto, selecione ASP.NET Core Web App (Razor Pages)>Next.

  • Na caixa de diálogo Configurar seu novo projeto, digite RazorPagesMovie para nome do projeto. É importante nomear o projeto RazorPagesMovie, incluindo a correspondência de maiúsculas, para que os namespaces correspondam quando você copiar e colar código de exemplo.

  • Selecione Avançar.

  • No Informações adicionais caixa de diálogo:

    • Selecione .NET 8.0 (Suporte de longo prazo).
    • Verificar: Não use instruções de nível superior está desmarcada.

  • Selecione Criar.

    Informações adicionais

    O seguinte projeto inicial é criado:

    Gerenciador de Soluções

Para abordagens alternativas para criar o projeto, consulte Criar um novo projeto no Visual Studio.

Executar o aplicativo

Selecione RazorPagesMovie no Gerenciador de Soluções e pressione Ctrl+F5 para executar o aplicativo sem o depurador.

Visual Studio exibe a seguinte caixa de diálogo quando um projeto ainda não está configurado para usar SSL:

Este projeto está configurado para usar SSL. Para evitar avisos SSL no navegador, você pode optar por confiar no certificado autoassinado que o IIS Express gerou. Gostaria de confiar no certificado SSL do IIS Express?

Selecione Sim se confiar no certificado SSL do IIS Express.

A seguinte caixa de diálogo é exibida:

Caixa de diálogo de aviso de segurança

Selecione Sim se concordar em confiar no certificado de desenvolvimento.

Para obter informações sobre como confiar no navegador Firefox, consulte o erro de certificado do Firefox SEC_ERROR_INADEQUATE_KEY_USAGE .

Visual Studio:

  • Executa o aplicativo, que inicia o servidor Kestrel.
  • Inicia o navegador padrão em https://localhost:<port>, que exibe a interface de utilizador da aplicação. <port> é a porta aleatória atribuída quando o aplicativo foi criado.

Feche a janela do navegador.

Examinar os arquivos do projeto

As seções a seguir contêm uma visão geral das principais pastas e arquivos do projeto com os quais você trabalhará em tutoriais posteriores.

Pasta Pages

Contém Razor páginas e ficheiros de suporte. Cada página Razor é um par de ficheiros:

  • Um arquivo .cshtml que tem marcação HTML com código C# usando sintaxe Razor.
  • Um arquivo .cshtml.cs que tem código C# que manipula eventos de página.

Os arquivos de suporte têm nomes que começam com um sublinhado. Por exemplo, o arquivo _Layout.cshtml configura elementos da interface do usuário comuns a todas as páginas. _Layout.cshtml configura o menu de navegação na parte superior da página e o aviso de direitos autorais na parte inferior da página. Para obter mais informações, consulte layout no ASP.NET Core.

pasta wwwroot

Contém ativos estáticos, como arquivos HTML, JavaScript e CSS. Para obter mais informações, consulte arquivos estáticos no ASP.NET Core.

appsettings.json

Contém dados de configuração, como cadeias de conexão. Para obter mais informações, consulte Configuração no ASP.NET Core.

Program.cs

Contém o seguinte código:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

As seguintes linhas de código neste ficheiro criam um WebApplicationBuilder com valores predefinidos, adicionam suporte Razor Pages ao contentor Injeção de Dependência (DI)e compila a aplicação:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

A página de exceção do desenvolvedor é habilitada por padrão e fornece informações úteis sobre exceções. Os aplicativos de produção não devem ser executados no modo de desenvolvimento porque a página de exceção do desenvolvedor pode vazar informações confidenciais.

O código a seguir define o ponto de extremidade de exceção como /Error e habilita HTTP Strict Transport Security Protocol (HSTS) quando o aplicativo não está em execução no modo de desenvolvimento:

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

Por exemplo, o código anterior é executado quando o aplicativo está no modo de produção ou teste. Para obter mais informações, consulte Usar vários ambientes no ASP.NET Core.

O código a seguir habilita vários "Middleware" :

  • app.UseHttpsRedirection(); : Redireciona solicitações HTTP para HTTPS.
  • app.UseStaticFiles(); : Permite que arquivos estáticos, como HTML, CSS, imagens e JavaScript sejam servidos. Para obter mais informações, consulte ficheiros estáticos no ASP.NET Core.
  • app.UseRouting(); : Adiciona correspondência de rota ao pipeline de middleware. Para obter mais informações, consulte Roteamento no ASP.NET Core
  • app.MapRazorPages();: Configura o roteamento de endpoints para Páginas Razor.
  • app.UseAuthorization(); : Autoriza um usuário a acessar recursos seguros. Este aplicativo não usa autorização, portanto, esta linha pode ser removida.
  • app.Run(); : Executa o aplicativo.

Solução de problemas com o exemplo concluído

Se você encontrar um problema que não pode resolver, compare seu código com o projeto concluído. Ver ou transferir o projeto concluído (como transferir).

Próximos passos

Próximo: Adicionar um modelo

Este é o primeiro tutorial de uma série que ensina os conceitos básicos da criação de um aplicativo Web ASP.NET Core Razor Pages.

Para obter uma introdução mais avançada destinada a desenvolvedores que estão familiarizados com controladores e modos de exibição, consulte Introdução ao Razor Pages. Para uma introdução em vídeo, consulte Entity Framework Core for Beginners.

Se és novo no desenvolvimento do ASP.NET Core e não tens a certeza de qual a solução de interface de utilizador web ASP.NET Core melhor se adapta às tuas necessidades, consulta o tópico Escolher uma interface de utilizador do ASP.NET Core.

No final deste tutorial, você terá um aplicativo Web Razor Pages que gerencia um banco de dados de filmes.

Home ou Página de índice

Pré-requisitos

  • Visual Studio 2022 com a carga de trabalho de ASP.NET e desenvolvimento web.

    cargas de trabalho do instalador do VS22

Criar uma aplicação web Razor Pages

  • Inicie o Visual Studio e selecione Criar um novo projeto.

  • Na caixa de diálogo Criar um novo projeto, selecione ASP.NET Core Web App>Next.

  • Na caixa de diálogo Configurar o seu novo projeto, digite RazorPagesMovie para Nome do projeto. É importante nomear o projeto RazorPagesMovie, assegurando a correspondência de maiúsculas, de modo a garantir que os namespaces coincidam quando se copiar e colar código de exemplo.

  • Selecione Avançar.

  • Na caixa de diálogo Informações adicionais:

    • Selecione .NET 7.0 (Suporte de Termo Padrão).
    • Verificar: Não use instruções de nível superior está desmarcada.

  • Selecione Criar.

    Informações adicionais

    O seguinte projeto inicial é criado:

    Gerenciador de Soluções

Para abordagens alternativas para criar o projeto, consulte Criar um novo projeto no Visual Studio.

Executar o aplicativo

Selecione RazorPagesMovie no Gerenciador de Soluções e pressione Ctrl+F5 para executar o aplicativo sem o depurador.

Visual Studio exibe a seguinte caixa de diálogo quando um projeto ainda não está configurado para usar SSL:

Este projeto está configurado para usar SSL. Para evitar avisos SSL no navegador, você pode optar por confiar no certificado autoassinado que o IIS Express gerou. Gostaria de confiar no certificado SSL do IIS Express?

Selecione Sim se confiar no certificado SSL do IIS Express.

A seguinte caixa de diálogo é exibida:

Caixa de diálogo de aviso de segurança

Selecione Sim se concordar em confiar no certificado de desenvolvimento.

Para obter informações sobre como confiar no navegador Firefox, veja o erro de certificado do Firefox SEC_ERROR_INADEQUATE_KEY_USAGE .

Visual Studio:

  • Executa o aplicativo, que inicia o servidor Kestrel.
  • Inicia o navegador padrão em https://localhost:<port>, que exibe a interface do usuário do aplicativo. <port> é a porta aleatória atribuída quando o aplicativo foi criado.

Feche a janela do navegador.

Examinar os arquivos do projeto

As seções a seguir contêm uma visão geral das principais pastas e arquivos do projeto com os quais você trabalhará em tutoriais posteriores.

Pasta de Páginas

Contém Razor páginas e ficheiros de suporte. Cada página Razor é um par de ficheiros:

  • Um arquivo .cshtml que tem marcação HTML com código C# usando sintaxe Razor.
  • Um arquivo .cshtml.cs que tem código C# que manipula eventos de página.

Os arquivos de suporte têm nomes que começam com um sublinhado. Por exemplo, o arquivo _Layout.cshtml configura elementos da interface do usuário comuns a todas as páginas. _Layout.cshtml configura o menu de navegação na parte superior da página e o aviso de direitos autorais na parte inferior da página. Para obter mais informações, consulte layout no ASP.NET Core.

pasta wwwroot

Contém ativos estáticos, como arquivos HTML, JavaScript e CSS. Para obter mais informações, consulte ficheiros estáticos no ASP.NET Core.

appsettings.json

Contém dados de configuração, como cadeias de conexão. Para obter mais informações, consulte Configuração no ASP.NET Core.

Program.cs

Contém o seguinte código:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

As seguintes linhas de código neste ficheiro criam um WebApplicationBuilder com predefinições pré-configuradas, adicionam suporte Razor Pages ao contentor de Injeção de Dependência (DI)e constroem a aplicação:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

A página de exceção do desenvolvedor é habilitada por padrão e fornece informações úteis sobre exceções. Os aplicativos de produção não devem ser executados no modo de desenvolvimento porque a página de exceção do desenvolvedor pode vazar informações confidenciais.

O código a seguir define o ponto de extremidade de exceção como /Error e habilita HTTP Strict Transport Security Protocol (HSTS) quando o aplicativo não está em execução no modo de desenvolvimento:

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

Por exemplo, o código anterior é executado quando o aplicativo está no modo de produção ou teste. Para obter mais informações, consulte Usar vários ambientes no ASP.NET Core.

O código a seguir habilita vários Middleware:

  • app.UseHttpsRedirection(); : Redireciona solicitações HTTP para HTTPS.
  • app.UseStaticFiles(); : Permite que arquivos estáticos, como HTML, CSS, imagens e JavaScript sejam servidos. Para obter mais informações, consulte ficheiros estáticos no ASP.NET Core.
  • app.UseRouting(); : Adiciona correspondência de rota ao pipeline de middleware. Para mais informações, consulte Roteamento no ASP.NET Core
  • app.MapRazorPages();: Configura o roteamento de endpoints para Razor Pages.
  • app.UseAuthorization(); : Autoriza um usuário a acessar recursos seguros. Este aplicativo não usa autorização, portanto, esta linha pode ser removida.
  • app.Run(); : Executa o aplicativo.

Solução de problemas com o exemplo concluído

Se você encontrar um problema que não pode resolver, compare seu código com o projeto concluído. Ver ou descarregar o projeto concluído (como fazer o download).

Próximos passos

Próximo: Adicionar um modelo

Este é o primeiro tutorial de uma série que ensina os conceitos básicos da criação de um aplicativo Web ASP.NET Core Razor Pages.

Para obter uma introdução mais avançada destinada a desenvolvedores que estão familiarizados com controladores e modos de exibição, consulte Introdução ao Razor Pages. Para uma introdução em vídeo, consulte Entity Framework Core for Beginners.

Se és novo no desenvolvimento do ASP.NET Core e não tens certeza de qual solução de interface do utilizador web do ASP.NET Core melhor atenderá às tuas necessidades, consulta Escolher uma interface do utilizador do ASP.NET Core.

No final da série, você terá um aplicativo que gerencia um banco de dados de filmes.

Neste tutorial, você:

  • Crie um aplicativo Web Razor Páginas.
  • Execute o aplicativo.
  • Examine os arquivos do projeto.

No final deste tutorial, você terá um aplicativo Web Razor Pages em funcionamento que será aprimorado em tutoriais posteriores.

Home ou Página de índice

Pré-requisitos

  • Visual Studio 2022 com a carga de trabalho de ASP.NET e desenvolvimento web.
  • SDK do .NET 6.0

Criar uma aplicação web Razor Pages

  1. Inicie o Visual Studio 2022 e selecione Criar um novo projeto.

    Criar um novo projeto a partir da janela inicial

  2. Na caixa de diálogo Criar um novo projeto , selecione ASP.NET Core Web Appe, em seguida, selecione Seguinte.

    Criar uma ASP.NET Core Web App

  3. Na caixa de diálogo Configurar o seu novo projeto, digite RazorPagesMovie para o nome do projeto. É importante nomear o projeto RazorPagesMovie, incluindo a correspondência das maiúsculas, para que os namespaces correspondam quando si copiar e colar o código de exemplo.

    Configure seu novo projeto

  4. Selecione Avançar.

  5. Na caixa de diálogo Informações adicionais, selecione .NET 6.0 (Suporte de longo prazo) e, em seguida, selecione Criar.

    Informações adicionais

O seguinte projeto inicial é criado:

Gerenciador de Soluções

Executar o aplicativo

Selecione RazorPagesMovie no Gerenciador de Soluções e pressione Ctrl+F5 para executar sem o depurador.

Visual Studio exibe a seguinte caixa de diálogo quando um projeto ainda não está configurado para usar SSL:

Este projeto está configurado para usar SSL. Para evitar avisos SSL no navegador, você pode optar por confiar no certificado autoassinado que o IIS Express gerou. Gostaria de confiar no certificado SSL do IIS Express?

Selecione Sim se confiar no certificado SSL do IIS Express.

A seguinte caixa de diálogo é exibida:

Caixa de diálogo de aviso de segurança

Selecione Sim se concordar em confiar no certificado de desenvolvimento.

Para obter informações sobre como confiar no navegador Firefox, consulte o erro de certificado Firefox SEC_ERROR_INADEQUATE_KEY_USAGE .

Visual Studio:

  • Executa o aplicativo, que inicia o servidor Kestrel.
  • Inicia o navegador padrão em https://localhost:5001, que exibe a interface do usuário do aplicativo.

Examinar os arquivos do projeto

As seções a seguir contêm uma visão geral das principais pastas e arquivos do projeto com os quais você trabalhará em tutoriais posteriores.

Pasta de Páginas

Contém Razor páginas e arquivos de suporte. Cada página Razor é um par de ficheiros:

  • Um arquivo .cshtml que tem marcação HTML com código C# usando sintaxe Razor.
  • Um arquivo .cshtml.cs que tem código C# que manipula eventos de página.

Os arquivos de suporte têm nomes que começam com um sublinhado. Por exemplo, o arquivo _Layout.cshtml configura elementos da interface do usuário comuns a todas as páginas. Este ficheiro configura o menu de navegação na parte superior da página e a declaração de direitos de autor na parte inferior da página. Para obter mais informações, consulte layout no ASP.NET Core.

pasta wwwroot

Contém ativos estáticos, como arquivos HTML, JavaScript e CSS. Para obter mais informações, consulte ficheiros estáticos no ASP.NET Core.

appsettings.json

Contém dados de configuração, como cadeias de conexão. Para obter mais informações, consulte Configuração no ASP.NET Core.

Program.cs

Contém o seguinte código:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

As seguintes linhas de código neste arquivo criam um WebApplicationBuilder com padrões pré-configurados, adicionam suporte a Razor Pages ao contêiner Dependency Injection (DI)e criam o aplicativo:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

A página de exceção do desenvolvedor é habilitada por padrão e fornece informações úteis sobre exceções. Os aplicativos de produção não devem ser executados no modo de desenvolvimento porque a página de exceção do desenvolvedor pode vazar informações confidenciais.

O código a seguir define o ponto de extremidade de exceção como /Error e habilita HTTP Strict Transport Security Protocol (HSTS) quando o aplicativo não está em execução no modo de desenvolvimento:

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

Por exemplo, o código anterior é executado quando o aplicativo está no modo de produção ou teste. Para obter mais informações, consulte Usar vários ambientes no ASP.NET Core.

O código a seguir habilita vários Middleware:

  • app.UseHttpsRedirection(); : Redireciona solicitações HTTP para HTTPS.
  • app.UseStaticFiles(); : Permite que arquivos estáticos, como HTML, CSS, imagens e JavaScript sejam servidos. Para obter mais informações, consulte ficheiros estáticos no ASP.NET Core.
  • app.UseRouting(); : Adiciona correspondência de rota ao pipeline de middleware. Para obter mais informações, consulte Roteamento no ASP.NET Core
  • app.MapRazorPages();: Configura o roteamento dos terminais para as páginas Razor.
  • app.UseAuthorization(); : Autoriza um usuário a acessar recursos seguros. Este aplicativo não usa autorização, portanto, esta linha pode ser removida.
  • app.Run(); : Executa o aplicativo.

Solução de problemas com o exemplo concluído

Se você encontrar um problema que não pode resolver, compare seu código com o projeto concluído. Ver ou descarregar do projeto completo (como descarregar).

Próximos passos

Próximo: Adicionar um modelo

Este é o primeiro tutorial de uma série que ensina os conceitos básicos da criação de um aplicativo Web ASP.NET Core Razor Pages.

Para obter uma introdução mais avançada destinada a desenvolvedores que estão familiarizados com controladores e modos de exibição, consulte Introdução ao Razor Pages.

Se és novo no desenvolvimento ASP.NET Core e não tens certeza de qual solução de interface de utilizador web ASP.NET Core é a melhor para os teus requisitos, consulta Escolhe uma interface de utilizador ASP.NET Core.

No final da série, você terá um aplicativo que gerencia um banco de dados de filmes.

Neste tutorial, você:

  • Crie uma aplicação web RazorPáginas.
  • Execute o aplicativo.
  • Examine os arquivos do projeto.

No final deste tutorial, você terá um aplicativo Web Razor Pages em funcionamento que será aprimorado em tutoriais posteriores.

Home ou Página de índice

Pré-requisitos

  • Visual Studio 2019 16.8 ou posterior com a carga de trabalho de ASP.NET e desenvolvimento Web
  • SDK do .NET 5.0

Criar uma aplicação Web Razor Páginas

  1. Inicie o Visual Studio e selecione Criar um novo projeto. Para obter mais informações, consulte Criar um novo projeto no Visual Studio.

    Criar um novo projeto a partir da janela inicial

  2. Na caixa de diálogo Criar um novo projeto, selecione Aplicação Web ASP.NET Coree, em seguida, selecione Avançar.

    Criar um aplicativo Web ASP.NET Core

  3. Na caixa de diálogo Configurar o seu novo projeto, digite RazorPagesMovie para nome do projeto. É importante nomear o projeto RazorPagesMovie, não esquecendo as maiúsculas, para que os namespaces correspondam quando copiar e colar o código de exemplo.

  4. Selecione Criar.

    Configurar o projeto

  5. Na caixa de diálogo Criar um novo aplicativo Web ASP.NET Core, selecione:

    1. .NET Core e ASP.NET Core 5.0 nos menus suspensos.
    2. Aplicação Web.
    3. Criar.

    Selecionar aplicação Web ASP.NET Core

O seguinte projeto inicial é criado:

Gerenciador de Soluções

Executar o aplicativo

  • Pressione Ctrl+F5 para executar sem o depurador.

    Visual Studio exibe a seguinte caixa de diálogo quando um projeto ainda não está configurado para usar SSL:

    Este projeto está configurado para usar SSL. Para evitar avisos SSL no navegador, você pode optar por confiar no certificado autoassinado que o IIS Express gerou. Gostaria de confiar no certificado SSL do IIS Express?

    Selecione Sim se confiar no certificado SSL do IIS Express.

    A seguinte caixa de diálogo é exibida:

    Caixa de diálogo de aviso de segurança

    Selecione Sim se concordar em confiar no certificado de desenvolvimento.

    Para obter informações sobre como confiar no navegador Firefox, consulte o erro de certificado Firefox SEC_ERROR_INADEQUATE_KEY_USAGE em .

    O Visual Studio inicia IIS Express e executa o aplicativo. A barra de endereço mostra localhost:port# e não algo como example.com. Isso porque localhost é o nome de host padrão para o computador local. Localhost atende apenas solicitações da Web do computador local. Quando o Visual Studio cria um projeto Web, uma porta aleatória é usada para o servidor Web.

Examinar os arquivos do projeto

Aqui está uma visão geral das principais pastas e arquivos do projeto com os quais você trabalhará em tutoriais posteriores.

Pasta de Páginas

Contém Razor páginas e ficheiros de suporte. Cada página Razor é um par de ficheiros:

  • Um arquivo .cshtml que tem marcação HTML com código C# usando sintaxe Razor.
  • Um arquivo .cshtml.cs que tem código C# que manipula eventos de página.

Os arquivos de suporte têm nomes que começam com um sublinhado. Por exemplo, o arquivo _Layout.cshtml configura elementos da interface do usuário comuns a todas as páginas. Este ficheiro configura o menu de navegação na parte superior da página e a declaração de direitos de autor na parte inferior da página. Para obter mais informações, consulte layout no ASP.NET Core.

pasta wwwroot

Contém ativos estáticos, como arquivos HTML, JavaScript e CSS. Para obter mais informações, consulte ficheiros estáticos no ASP.NET Core.

appsettings.json

Contém dados de configuração, como cadeias de conexão. Para obter mais informações, consulte Configuração no ASP.NET Core.

Program.cs

Contém o ponto de entrada para a aplicação. Para mais informações, consulte o Host Genérico do .NET no ASP.NET Core.

Startup.cs

Contém código que configura o comportamento do aplicativo. Para obter mais informações, consulte inicialização do aplicativo no ASP.NET Core.

Solução de problemas com o exemplo concluído

Se você encontrar um problema que não pode resolver, compare seu código com o projeto concluído. Ver ou transferir projeto concluído (como transferir).

Próximos passos

Próximo: Adicionar um modelo

Este é o primeiro tutorial de uma série que ensina os conceitos básicos da criação de um aplicativo Web ASP.NET Core Razor Pages.

Para obter uma introdução mais avançada destinada a desenvolvedores que estão familiarizados com controladores e modos de exibição, consulte Introdução ao Razor Pages.

No final da série, você terá um aplicativo que gerencia um banco de dados de filmes.

Ver ou descarregar código de exemplo (como fazer o download).

Neste tutorial, você:

  • Crie um aplicativo Web Razor Páginas.
  • Execute o aplicativo.
  • Examine os arquivos do projeto.

No final deste tutorial, você terá um aplicativo Web do Razor Pages em funcionamento que será desenvolvido em tutoriais posteriores.

A página Home ou página de Índice

Pré-requisitos

  • Visual Studio 2019 16.4 ou posterior com a carga de trabalho de ASP.NET e desenvolvimento Web
  • SDK do .NET Core 3.1

Criar uma aplicação Web Razor Pages

  • No menu Visual Studio Ficheiro, selecione Novo>Projeto.

  • Crie um novo ASP.NET Core Web Application e selecione Next. Criar o novo projeto a partir da janela Iniciar

  • Nomeie o projeto RazorPagesMovie. É importante nomear o projeto RazorPagesMovie para que os namespaces correspondam quando você copiar e colar código. Nomeie o projeto

  • Selecione ASP.NET Core 3.1 na lista suspensa,Aplicação Web , e em seguida, selecioneCriar .

Selecionar ASP.NET aplicativo Web principal

O seguinte projeto inicial é criado:

Gerenciador de Soluções

Executar o aplicativo

  • Pressione Ctrl+F5 para executar sem o depurador.

    Visual Studio exibe a seguinte caixa de diálogo quando um projeto ainda não está configurado para usar SSL:

    Este projeto está configurado para usar SSL. Para evitar avisos SSL no navegador, você pode optar por confiar no certificado autoassinado que o IIS Express gerou. Gostaria de confiar no certificado SSL do IIS Express?

    Selecione Sim se confiar no certificado SSL do IIS Express.

    A seguinte caixa de diálogo é exibida:

    Caixa de diálogo de aviso de segurança

    Selecione Sim se concordar em confiar no certificado de desenvolvimento.

    Para obter informações sobre como confiar no navegador Firefox, consulte de erro de certificado do Firefox SEC_ERROR_INADEQUATE_KEY_USAGE .

    O Visual Studio inicia IIS Express e executa o aplicativo. A barra de endereço mostra localhost:port# e não algo como example.com. Isso porque localhost é o nome de host padrão para o computador local. Localhost atende apenas solicitações da Web do computador local. Quando o Visual Studio cria um projeto Web, uma porta aleatória é usada para o servidor Web.

Examinar os arquivos do projeto

Aqui está uma visão geral das principais pastas e arquivos do projeto com os quais você trabalhará em tutoriais posteriores.

Pasta de Páginas

Contém Razor páginas e ficheiros de suporte. Cada página Razor é um par de ficheiros:

  • Um arquivo .cshtml que tem marcação HTML com código C# usando sintaxe Razor.
  • Um arquivo .cshtml.cs que tem código C# que manipula eventos de página.

Os arquivos de suporte têm nomes que começam com um sublinhado. Por exemplo, o arquivo _Layout.cshtml configura elementos da interface do usuário comuns a todas as páginas. Este ficheiro configura o menu de navegação na parte superior da página e a declaração de direitos de autor na parte inferior da página. Para obter mais informações, consulte layout no ASP.NET Core.

pasta wwwroot

Contém arquivos estáticos, como arquivos HTML, JavaScript e CSS. Para obter mais informações, consulte ficheiros estáticos no ASP.NET Core.

appSettings.json

Contém dados de configuração, como cadeias de conexão. Para obter mais informações, consulte Configuração no ASP.NET Core.

Program.cs

Contém o ponto de entrada para o programa. Para obter mais informações, consulte o Host Genérico .NET no ASP.NET Core.

Startup.cs

Contém código que configura o comportamento do aplicativo. Para obter mais informações, consulte inicialização do aplicativo no ASP.NET Core.

Próximos passos

Próximo: Adicionar um modelo