Samouczek: Rozpoczynanie pracy ze stronami Razor w programie ASP.NET CoreTutorial: Get started with Razor Pages in ASP.NET Core

Przez Rick AndersonBy Rick Anderson

To jest pierwszy samouczek serii.This is the first tutorial of a series. Seria uczy podstaw tworzenia aplikacji platformy ASP.NET Core Razor strony sieci web.The series teaches the basics of building an ASP.NET Core Razor Pages web app.

Wprowadzenie bardziej zaawansowanych, zmierzające do doświadczonych deweloperów — zobacz wprowadzenie do stron Razor.For a more advanced introduction aimed at experienced developers, see Introduction to Razor Pages.

Na końcu serii będziesz mieć aplikację, która zarządza bazy danych filmów.At the end of the series, you'll have an app that manages a database of movies.

Wyświetlanie lub pobieranie przykładowego kodu (sposobu pobierania).View or download sample code (how to download).

W ramach tego samouczka możesz:In this tutorial, you:

  • Tworzenie aplikacji internetowej stron Razor.Create a Razor Pages web app.
  • Uruchom aplikację.Run the app.
  • Sprawdź pliki projektu.Examine the project files.

Na końcu tego samouczka będziesz mieć działającą aplikację sieci web stron Razor, które utworzysz w kolejnych samouczkach.At the end of this tutorial, you'll have a working Razor Pages web app that you'll build on in later tutorials.

Strona główna lub indeks

Wymagania wstępnePrerequisites

Tworzenie aplikacji sieci web stron RazorCreate a Razor Pages web app

  • W programie Visual Studio pliku menu, wybierz opcję New > projektu.From the Visual Studio File menu, select New > Project.

  • Tworzenie nowej aplikacji sieci Web platformy ASP.NET Core i wybierz dalej.Create a new ASP.NET Core Web Application and select Next.

    Nowa aplikacja internetowa ASP.NET Core

  • Nadaj projektowi nazwę RazorPagesMovie.Name the project RazorPagesMovie. Ważne jest, aby nadaj projektowi nazwę RazorPagesMovie , przestrzenie nazw będą zgodne po skopiuj i Wklej kod.It's important to name the project RazorPagesMovie so the namespaces will match when you copy and paste code.

    Nowa aplikacja internetowa ASP.NET Core

  • Wybierz platformy ASP.NET Core 2.2 na liście rozwijanej aplikacji sieci Web, a następnie wybierz pozycję Utwórz.Select ASP.NET Core 2.2 in the dropdown, Web Application, and then select Create.

Nowa aplikacja internetowa ASP.NET Core

Utworzono następujący projekt startowy:The following starter project is created:

Eksplorator rozwiązań

Uruchamianie aplikacjiRun the app

  • Naciśnij klawisze Ctrl + F5, aby uruchomić bez debugowania.Press Ctrl+F5 to run without the debugger.

    Program Visual Studio wyświetla następujące okno dialogowe:Visual Studio displays the following dialog:

    Ten projekt został skonfigurowany do używania protokołu SSL.

    Wybierz tak czy ufa certyfikatowi SSL usług IIS Express.Select Yes if you trust the IIS Express SSL certificate.

    Zostanie wyświetlone następujące okno dialogowe:The following dialog is displayed:

    Okno dialogowe ostrzeżenia o zabezpieczeniach

    Wybierz Tak, jeśli zgadzasz się ufać certyfikatowi programistycznemu.Select Yes if you agree to trust the development certificate.

    Zobacz ufać certyfikatowi rozwoju platformy ASP.NET Core HTTPS Aby uzyskać więcej informacji.See Trust the ASP.NET Core HTTPS development certificate for more information.

    Program Visual Studio uruchamia usług IIS Express i uruchomienie aplikacji.Visual Studio starts IIS Express and runs the app. Przedstawia pasek adresu localhost:port# i nie mielibyśmy mieć czegoś podobnego example.com.The address bar shows localhost:port# and not something like example.com. To dlatego, że localhost jest standardowa nazwa hosta komputera lokalnego.That's because localhost is the standard hostname for the local computer. Localhost obsługują tylko żądania sieci web z komputera lokalnego.Localhost only serves web requests from the local computer. Gdy program Visual Studio tworzy projekt sieci web, losowy port jest używany dla serwera sieci web.When Visual Studio creates a web project, a random port is used for the web server.

  • Na stronie głównej aplikacji, wybierz Akceptuj do wyrażenia zgody na śledzenie.On the app's home page, select Accept to consent to tracking.

    Ta aplikacja nie może śledzić informacje osobiste, ale szablonu projektu obejmuje funkcję zgody, w przypadku, gdy będą potrzebne do wykonania w Unii Europejskiej ogólne rozporządzenie o ochronie danych (RODO).This app doesn't track personal information, but the project template includes the consent feature in case you need it to comply with the European Union's General Data Protection Regulation (GDPR).

    Strona główna lub indeks

    Na poniższej ilustracji przedstawiono aplikację po zgody śledzenia:The following image shows the app after you give consent to tracking:

    Strona główna lub indeks

Przejrzyj pliki projektuExamine the project files

Poniżej przedstawiono omówienie folderów głównego projektu i plików, które będziesz pracować w kolejnych samouczkach.Here's an overview of the main project folders and files that you'll work with in later tutorials.

Folder stronPages folder

Zawiera stronami Razor i pliki pomocnicze.Contains Razor pages and supporting files. Każda strona Razor jest parę plików:Each Razor page is a pair of files:

  • A .cshtml pliku, który zawiera kod znaczników HTML za pomocą C# kodu przy użyciu składni Razor.A .cshtml file that contains HTML markup with C# code using Razor syntax.
  • A . cshtml.cs pliku, który zawiera C# kod, który obsługuje zdarzenia strony.A .cshtml.cs file that contains C# code that handles page events.

Pliki obsługi mają nazwy rozpoczynające się od znaku podkreślenia.Supporting files have names that begin with an underscore. Na przykład _Layout.cshtml plik konfiguruje elementy interfejsu użytkownika dla wszystkich stron.For example, the _Layout.cshtml file configures UI elements common to all pages. Ten plik konfiguruje menu nawigacji w górnej części strony i informacje o prawach autorskich w dolnej części strony.This file sets up the navigation menu at the top of the page and the copyright notice at the bottom of the page. Aby uzyskać więcej informacji, zobacz Układ w programie ASP.NET Core.For more information, see Układ w programie ASP.NET Core.

Wwwroot folderwwwroot folder

Zawiera pliki statyczne, takie jak pliki HTML, plików JavaScript i plików CSS.Contains static files, such as HTML files, JavaScript files, and CSS files. Aby uzyskać więcej informacji, zobacz Pliki statyczne z platformy ASP.NET Core.For more information, see Pliki statyczne z platformy ASP.NET Core.

appSettings.jsonappSettings.json

Zawiera dane konfiguracyjne, takie jak parametry połączenia.Contains configuration data, such as connection strings. Aby uzyskać więcej informacji, zobacz Konfiguracja w programie ASP.NET Core.For more information, see Konfiguracja w programie ASP.NET Core.

Program.csProgram.cs

Zawiera punkt wejścia programu.Contains the entry point for the program. Aby uzyskać więcej informacji, zobacz Ogólny hosta platformy .NET.For more information, see Ogólny hosta platformy .NET.

Startup.csStartup.cs

Zawiera kod, który konfiguruje zachowania aplikacji, na przykład tego, czy wymaga zgody na pliki cookie.Contains code that configures app behavior, such as whether it requires consent for cookies. Aby uzyskać więcej informacji, zobacz Uruchamianie aplikacji w programie ASP.NET Core.For more information, see Uruchamianie aplikacji w programie ASP.NET Core.

Dodatkowe zasobyAdditional resources

Następne krokiNext steps

W ramach tego samouczka możesz:In this tutorial, you:

  • Utworzona aplikacja internetowa ze stronami Razor.Created a Razor Pages web app.
  • Uruchomienia aplikacji.Ran the app.
  • Zbadane plików projektu.Examined the project files.

Przejdź do następnego samouczka w serii:Advance to the next tutorial in the series: