Samouczek: rozpoczynanie pracy z językiem C# i ASP.NET Core w programie Visual Studio

W tym samouczku dotyczącym programowania w języku C# za pomocą platformy ASP.NET Core utworzysz aplikację internetową w języku C# ASP.NET Core w programie Visual Studio.

Ten samouczek przedstawia sposób wykonania następujących czynności:

• Tworzenie projektu programu Visual Studio
• Tworzenie aplikacji internetowej w języku C# ASP.NET Core
• Wprowadzanie zmian w aplikacji internetowej
• Eksplorowanie funkcji środowiska IDE
• Uruchom aplikację internetową

Wymagania wstępne

Do ukończenia tego samouczka potrzebny jest program Visual Studio. Odwiedź stronę pobierania programu Visual Studio, aby uzyskać bezpłatną wersję.

• Aby uzyskać więcej informacji na temat uaktualniania do najnowszej wersji programu Visual Studio, zobacz Aktualizacje programu Visual Studio.

• Aby dostosować środowisko programu Visual Studio, zobacz personalizowanie środowiska IDE i edytora programu Visual Studio.

Tworzenie projektu

Najpierw należy utworzyć projekt ASP.NET Core. Typ projektu jest dostarczany ze wszystkimi plikami szablonów, które należy utworzyć w pełni funkcjonalną witrynę internetową.

1. W oknie uruchamiania wybierz pozycję Utwórz nowy projekt.

   

2. W oknie Tworzenie nowego projektu wybierz pozycję C# z listy Język. Następnie wybierz pozycję Windows z listy platformy i sieć Web z listy typów projektów.

   Po zastosowaniu filtrów języka, platformy i typu projektu wybierz szablon ASP.NET Core Web App , a następnie wybierz przycisk Dalej.

   

   Uwaga

   Jeśli nie widzisz szablonu ASP.NET Core Web App , możesz zainstalować go w oknie Tworzenie nowego projektu .

   W obszarze Nie można znaleźć szukanego komunikatu? w dolnej części listy szablonów wybierz link Zainstaluj więcej narzędzi i funkcji .

   

   W Instalator programu Visual Studio wybierz obciążenie ASP.NET i tworzenie aplikacji internetowych.

   

   Wybierz pozycję Modyfikuj w Instalator programu Visual Studio. Może zostać wyświetlony monit o zapisanie pracy. Wybierz pozycję Kontynuuj , aby zainstalować obciążenie.

   Wróć do kroku 2 w tej procedurze "Tworzenie projektu".

3. W oknie Konfigurowanie nowego projektu wprowadź ciąg MyCoreApp w polu Nazwa projektu. Następnie wybierz Dalej.

   

4. W oknie Dodatkowe informacje sprawdź, czy platforma .NET 8.0 jest wyświetlana w polu Platforma docelowa.

   W tym oknie możesz włączyć obsługę platformy Docker i dodać obsługę uwierzytelniania. Menu rozwijane typu uwierzytelniania ma następujące cztery opcje:

   • Brak: brak uwierzytelniania.
   • Indywidualne konta: te uwierzytelniania są przechowywane w lokalnej lub opartej na platformie Azure bazie danych.
   • Platforma tożsamości Microsoft: ta opcja używa identyfikatora Entra firmy Microsoft lub platformy Microsoft 365 do uwierzytelniania.
   • Windows: odpowiednie dla aplikacji intranetowych.

   Pozostaw pole Włącz platformę Docker niezaznaczone, a następnie wybierz pozycję Brak w polu Typ uwierzytelniania.

   

5. Wybierz pozycję Utwórz.

Program Visual Studio otwiera nowy projekt.

Informacje o rozwiązaniu

To rozwiązanie jest zgodne ze wzorcem projektowania strony Razor. Różni się on od wzorca projektowego Model-View-Controller (MVC) w taki sposób, że usprawniony jest dołączanie modelu i kodu kontrolera do samej strony Razor.

Przewodnik po rozwiązaniu

1. Szablon projektu tworzy rozwiązanie z jednym projektem ASP.NET Core o nazwie MyCoreApp. Wybierz kartę Eksplorator rozwiązań, aby wyświetlić jego zawartość.

   

2. Rozwiń folder Pages.

   

3. Wybierz plik Index.cshtml i wyświetl go w edytorze kodu.

   

4. Każdy plik cshtml ma skojarzony plik kodu. Aby otworzyć plik kodu w edytorze, rozwiń węzeł Index.cshtml w Eksplorator rozwiązań i wybierz plik Index.cshtml.cs.

   

5. Wyświetl plik Index.cshtml.cs w edytorze kodu.

   

6. Projekt zawiera folder wwwroot , który jest katalogiem głównym witryny internetowej. Rozwiń folder, aby wyświetlić jego zawartość.

   

   Zawartość witryny statycznej, taka jak CSS, obrazy i biblioteki JavaScript, można umieścić bezpośrednio w ścieżkach, w których chcesz.

7. Projekt zawiera również pliki konfiguracji, które zarządzają aplikacją internetową w czasie wykonywania. Domyślna konfiguracja aplikacji jest przechowywana w pliku appsettings.json. Można jednak zastąpić te ustawienia przy użyciu ustawień appsettings. Development.json. Rozwiń plik appsettings.json, aby wyświetlić ustawienia aplikacji. Plik Development.json.

   

Uruchamianie, debugowanie i wprowadzanie zmian

1. Na pasku narzędzi wybierz przycisk IIS Express , aby skompilować i uruchomić aplikację w trybie debugowania. Alternatywnie naciśnij klawisz F5 lub przejdź do pozycji Debuguj>rozpocznij debugowanie na pasku menu.

   

   Uwaga

   Jeśli zostanie wyświetlony komunikat o błędzie z komunikatem Nie można nawiązać połączenia z serwerem internetowym "IIS Express", zamknij program Visual Studio, a następnie uruchom ponownie program jako administrator. To zadanie można wykonać, klikając prawym przyciskiem myszy ikonę programu Visual Studio z menu Start, a następnie wybierając opcję Uruchom jako administrator z menu kontekstowego.

   Może również zostać wyświetlony komunikat z pytaniem, czy chcesz zaakceptować certyfikat SSL Express usług IIS. Aby wyświetlić kod w przeglądarce internetowej, wybierz pozycję Tak, a następnie wybierz pozycję Tak , jeśli zostanie wyświetlony komunikat ostrzegawczy zabezpieczeń.

2. Program Visual Studio uruchamia okno przeglądarki. Na pasku menu powinny zostać wyświetlone strony Strona główna i Prywatność .

3. Wybierz pozycję Prywatność na pasku menu. Strona Prywatność w przeglądarce renderuje tekst ustawiony w pliku Privacy.cshtml .

   

4. Wróć do programu Visual Studio, a następnie naciśnij klawisze Shift+F5 , aby zatrzymać debugowanie. Ta akcja powoduje zamknięcie projektu w oknie przeglądarki.

5. W programie Visual Studio otwórz plik Privacy.cshtml do edycji. Następnie usuń zdanie, użyj tej strony, aby szczegółowo wyszczególnić zasady ochrony prywatności witryny i zastąpić ją tą stroną jest w budowie @ViewDatajako ["Sygnatura czasowa"].

   

6. Teraz wprowadźmy zmianę kodu. Wybierz plik Privacy.cshtml.cs. Następnie wyczyść using dyrektywy w górnej części pliku, wybierając następujący skrót:

   Mouseover lub wybierz wyszarzone using dyrektywy. Żarówka Szybkie akcje jest wyświetlana poniżej daszka lub na lewym marginesie. Wybierz żarówkę, a następnie wybierz strzałkę rozwijania obok pozycji Usuń niepotrzebne użycie.

   

   Teraz wybierz pozycję Podgląd zmian , aby zobaczyć zmiany.

   

   Wybierz Zastosuj. Program Visual Studio usuwa niepotrzebne using dyrektywy z pliku.

7. Następnie utwórz ciąg dla bieżącej daty sformatowanej dla kultury lub regionu przy użyciu metody DateTime.ToString .

   • Pierwszy argument metody określa sposób wyświetlania daty. W tym przykładzie użyto specyfikatora formatu (d), który wskazuje format daty krótkiej.
   • Drugim argumentem jest obiekt CultureInfo , który określa kulturę lub region daty. Drugi argument określa między innymi język dowolnych słów w dacie i typ używanych separatorów.

   Zmień treść OnGet() metody na następujący kod:

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

8. Zwróć uwagę, że następująca using dyrektywa jest automatycznie dodawana do góry pliku:

   using System.Globalization;
   

   System.Globalization zawiera klasę CultureInfo .

9. Naciśnij klawisz F5 , aby otworzyć projekt w przeglądarce internetowej.

10. W górnej części witryny internetowej wybierz pozycję Prywatność , aby wyświetlić zmiany.

    

11. Zamknij przeglądarkę internetową, naciśnij klawisze Shift+F5, aby zatrzymać debugowanie.

Zmienianie strony głównej

1. W Eksplorator rozwiązań rozwiń folder Pages, a następnie wybierz pozycję Index.cshtml.

   

   Plik Index.cshtml odpowiada stronie głównej w aplikacji internetowej, która jest uruchamiana w przeglądarce internetowej.

   

   W edytorze kodu zobaczysz kod HTML dla tekstu wyświetlanego na stronie głównej.

   

2. Zastąp tekst powitalny wartością Hello World!

   

3. Wybierz pozycję IIS Express lub naciśnij klawisze Ctrl+F5 , aby uruchomić aplikację i otworzyć ją w przeglądarce internetowej.

   

4. W przeglądarce internetowej na stronie głównej są widoczne nowe zmiany.

   

5. Zamknij przeglądarkę internetową, naciśnij klawisze Shift+F5, aby zatrzymać debugowanie i zapisać projekt. Teraz możesz zamknąć program Visual Studio.

Następne kroki

Gratulujemy ukończenia tego samouczka! Mamy nadzieję, że poznasz język C#, ASP.NET Core i środowisko IDE programu Visual Studio. Aby dowiedzieć się więcej na temat tworzenia aplikacji internetowej lub witryny internetowej w języku C# i ASP.NET, przejdź do następującego samouczka:

Tworzenie aplikacji internetowej Razor Pages przy użyciu platformy ASP.NET Core

Możesz też dowiedzieć się, jak konteneryzować aplikację internetową za pomocą platformy Docker:

Narzędzia kontenerów w programie Visual Studio

Zobacz też

Publikowanie aplikacji internetowej w usłudze aplikacja systemu Azure przy użyciu programu Visual Studio