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

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

   

2. W oknie Utwórz nowy projekt z listy języków wybierz C# . Następnie wybierz pozycję windows z listy platformy, a 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 na koniec wybierz pozycję Dalej.

   

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

   

4. W oknie Dodatkowe informacje sprawdź, czy w polu Platforma docelowa pojawi się .NET Core 3.1.

   W tym oknie możesz włączyć obsługę platformy Docker i dodać obsługę uwierzytelniania. Menu rozwijane dla Typ 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.
   • platformy tożsamości firmy Microsoft: ta opcja używa identyfikatora Entra firmy Microsoft lub platformy Microsoft 365 do uwierzytelniania.
   • Windows: odpowiednie dla aplikacji intranetowych.

   Pozostaw niezaznaczone pole włącz platformy Docker i wybierz pozycję Brak dla pozycji Typ uwierzytelniania.

   

5. Wybierz pozycję Utwórz.

Program Visual Studio otwiera nowy projekt.

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

   

2. W oknie Utwórz nowy projekt wybierz pozycję C# z listy Języków. Następnie wybierz pozycję Windows z listy Wszystkie platformy, a Web z listy Wszystkie typy projektów.

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

   

3. W oknie Konfiguracja nowego projektu wprowadź MyCoreApp w polu Nazwa projektu. Następnie wybierz pozycję Dalej.

   

4. W oknie Dodatkowe informacje sprawdź, czy .NET 8.0 jest wyświetlana w polu Target Framework.

   W tym oknie możesz włączyć obsługę kontenerów i dodać obsługę uwierzytelniania. Menu rozwijane dla Typ 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.
   • platformy tożsamości firmy Microsoft: ta opcja używa identyfikatora Entra firmy Microsoft lub platformy Microsoft 365 do uwierzytelniania.
   • Windows: odpowiednie dla aplikacji intranetowych.

   Pozostaw pole Włącz obsługę kontenera niezaznaczone, a dla typu uwierzytelniania wybierz Brak.

   

5. Wybierz pozycję Utwórz.

Program Visual Studio otwiera nowy projekt.

Przewodnik po rozwiązaniu

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

   

2. Rozwiń folder Pages.

   

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

   

4. Każdy plik cshtml ma skojarzony plik kodu. Aby otworzyć plik kodu w edytorze, rozwiń węzeł Index.cshtml w Eksploratorze 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 twojej witryny. 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.

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

7. Rozwiń plik appsettings.json, aby wyświetlić plik appsettings.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 F5lub przejdź do Debugowanie>Rozpocznij debugowanie na pasku menu.

   

   Notatka

   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 Home i Privacy.

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

   pl-PL:

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

5. W programie Visual Studio otwórz Privacy.cshtml do edycji. Następnie usuń zdanie, Użyj tej strony, aby przedstawić szczegółowe informacje o polityce prywatności witryny i zastąp je Ta strona jest w budowie od @ViewData["TimeStamp"].

   

6. Teraz wprowadźmy zmianę kodu. Wybierz Privacy.cshtml.cs. Następnie wyczyść dyrektywy using w górnej części pliku, używając następującego skrótu:

   Najeżdżaj myszą lub wybierz wyszarzoną dyrektywę using. żarówka szybkich akcji pojawia się poniżej kursora lub na lewym marginesie. Wybierz żarówkę, a następnie wybierz pozycję Usuń niepotrzebne użycie przy użyciu.

   

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

   

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

7. Następnie w metodzie OnGet() zmień treść na następujący kod:

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

8. Zwróć uwagę, że pod DateTimepojawia się faliste podkreślenie. Pojawia się faliste podkreślenie, ponieważ ten typ nie jest uwzględniony w kontekście.

   

   Otwórz pasek narzędzi "Lista błędów" , aby zobaczyć wymienione tam te same błędy. Jeśli nie widzisz paska narzędzi listy błędów , przejdź do Wyświetl listę błędów> na górnym pasku menu.

   

9. Naprawmy ten błąd. W edytorze kodu umieść kursor w wierszu zawierającym błąd, a następnie wybierz żarówkę Szybkie akcje na lewym marginesie. Następnie z menu rozwijanego wybierz pozycję przy użyciu „using System”;, aby dodać tę dyrektywę na początku pliku i usunąć błędy.

   

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

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

    

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

Zmienianie strony głównej

1. W Eksploratorze rozwiązań rozwiń folder stron , a następnie wybierz Index.cshtml.

   

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

   

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

   

2. Zastąp tekst Welcome na Hello World!

   

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

   

4. W przeglądarce internetowej zobaczysz nowe zmiany na stronie Strona główna.

   

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

Zapoznaj się ze swoim rozwiązaniem

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 Eksploratorze 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 strony 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 appsettings.json. Można jednak zastąpić te ustawienia przy użyciu appsettings.Development.json. Rozwiń plik appsettings.json, aby wyświetlić plik appsettings.Development.json.

   

Uruchamianie, debugowanie i wprowadzanie zmian

1. Na pasku narzędzi wybierz przycisk https, aby skompilować i uruchomić aplikację w trybie debugowania. Alternatywnie naciśnij F5lub przejdź do Debugowanie>Rozpocznij debugowanie na pasku menu.

   

   Notatka

   Może również zostać wyświetlony komunikat z pytaniem, czy chcesz zaakceptować certyfikat SSL platformy ASP.NET Core. Aby wyświetlić kod w przeglądarce internetowej, wybierz Tak, a następnie wybierz Tak, jeśli zostanie wyświetlony komunikat ostrzegawczy zabezpieczeń. Dowiedz się więcej o włączaniu protokołu SSL w ASP.NET Core.

2. Program Visual Studio uruchamia okno przeglądarki. Na pasku menu powinny zostać wyświetlone strony Home i Privacy.

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

   

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

5. W programie Visual Studio otwórz Privacy.cshtml do edycji. Następnie usuń zdanie Użyj tej strony, aby opisać szczegółowo politykę prywatności witryny i zastąp je Ta strona jest w budowie @ViewData["Sygnatura czasowa"].

   

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

   Najedź kursorem lub wybierz wyszarzałą dyrektywę using. szybkie akcje żarówka 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 pozycję Zastosuj. Program Visual Studio usuwa niepotrzebne dyrektywy using 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 określający 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ść metody OnGet() w Privacy.cshtml.cs 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 dyrektywa using jest automatycznie dodawana do góry pliku:

   using System.Globalization;
   

   System.Globalization zawiera klasę CultureInfo.

9. Naciśnij 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 Shift+F5, aby zatrzymać debugowanie.

Zmienianie strony głównej

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

   

   Plik Index.cshtml odpowiada Twojej stronie Głównej w aplikacji internetowej, która działa w przeglądarce internetowej.

   

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

   

2. Zastąp tekst Welcome na Hello World!

   

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

   

4. W przeglądarce internetowej zobaczysz zmiany na stronie Strona główna.

   

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