Samouczek: tworzenie aplikacji konsolowej .NET przy użyciu programu Visual Studio Code

W tym samouczku pokazano, jak utworzyć i uruchomić aplikację konsolową platformy .NET przy użyciu programu Visual Studio Code i interfejsu wiersza polecenia platformy .NET. Zadania projektu, takie jak tworzenie, kompilowanie i uruchamianie projektu, są wykonywane przy użyciu interfejsu wiersza polecenia platformy .NET. Jeśli wolisz, możesz wykonać czynności opisane w tym samouczku za pomocą innego edytora kodu i uruchamiać polecenia w terminalu.

Wymagania wstępne

• Program Visual Studio Code z zainstalowanym rozszerzeniem języka C#.

  Jeśli masz zainstalowane rozszerzenie C# Dev Kit, odinstaluj je lub wyłącz. Nie jest on używany przez tę serię samouczków.

  Aby uzyskać informacje o sposobie instalowania rozszerzeń w programie Visual Studio Code, zobacz Witryna Marketplace rozszerzenia programu VS Code.

• Zestaw .NET 8 SDK.

Tworzenie aplikacji

Utwórz projekt aplikacji konsolowej platformy .NET o nazwie "HelloWorld".

1. Uruchom program Visual Studio Code.

2. Wybierz pozycję Plik Otwórz folder (Plik>>otwórz... w systemie macOS) z menu głównego.

3. W oknie dialogowym Otwieranie folderu utwórz folder HelloWorld i wybierz go. Następnie kliknij pozycję Wybierz folder (otwórz w systemie macOS).

   Nazwa folderu staje się nazwą projektu i nazwą przestrzeni nazw domyślnie. W dalszej części samouczka dodasz kod, który zakłada, że przestrzeń nazw projektu to HelloWorld.

4. W oknie dialogowym Czy ufasz autorom plików w tym folderze? wybierz pozycję Tak, ufam autorom. Autorom można ufać, ponieważ ten folder zawiera tylko pliki wygenerowane przez platformę .NET i dodane lub zmodyfikowane przez Ciebie.

5. Otwórz terminal w programie Visual Studio Code, wybierając pozycję Wyświetl>terminal z menu głównego.

   Terminal zostanie otwarty z wierszem polecenia w folderze HelloWorld.

6. W terminalu wprowadź następujące polecenie:

   dotnet new console --framework net8.0 --use-program-main
   

   Otwórz plik Program.cs, aby wyświetlić prostą aplikację utworzoną przez szablon:

   namespace HelloWorld;
   
   class Program
   {
       static void Main(string[] args)
       {
           Console.WriteLine("Hello, World!");
       }
   }
   

   Przy pierwszym otwarciu pliku cs program Visual Studio Code wyświetla monit o dodanie zasobów do kompilowania i debugowania aplikacji. Wybierz pozycję Tak, a program Visual Studio Code tworzy folder vscode z plikami launch.json i tasks.json .

   Uwaga

   Jeśli nie otrzymasz monitu lub przypadkowo go odrzucisz bez wybrania pozycji Tak, wykonaj następujące kroki, aby utworzyć plik launch.json i tasks.json:

   • Wybierz pozycję Uruchom>dodaj konfigurację z menu.
   • Wybierz pozycję .NET 5+ i .NET Core w wierszu polecenia Wybierz środowisko .

   Kod definiuje klasę , Programz pojedynczą metodą , Mainktóra przyjmuje tablicę String jako argument. Main to punkt wejścia aplikacji, metoda wywoływana automatycznie przez środowisko uruchomieniowe podczas uruchamiania aplikacji. Wszystkie argumenty wiersza polecenia podane podczas uruchamiania aplikacji są dostępne w tablicy args . Kod w metodzie MainConsole.WriteLine(String) wywołuje metodę w celu wyświetlenia komunikatu w oknie konsoli.

   Język C# ma funkcję o nazwie instrukcje najwyższego poziomu, która pozwala pominąć klasę Program i metodę Main . Ten samouczek nie używa tej funkcji. To, czy używasz go w programach, jest kwestią preferencji stylu. W poleceniu dotnet new , które utworzyło projekt, --use-program-main opcja uniemożliwiła korzystanie z instrukcji najwyższego poziomu.

Uruchom aplikację

Uruchom następujące polecenie w terminalu:

dotnet run

Program wyświetla tekst "Hello, World!" i kończy się.

Ulepszanie aplikacji

Rozszerz aplikację, aby wyświetlić monit o podanie nazwy użytkownika i wyświetlić go wraz z datą i godziną.

1. Otwórz plik Program.cs.

2. Zastąp zawartość Main metody w pliku Program.cs, czyli wierszem, który wywołuje Console.WriteLinemetodę , następującym kodem:

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   Ten kod wyświetla monit w oknie konsoli i czeka, aż użytkownik wprowadzi ciąg, po którym następuje klawisz Enter . Przechowuje ten ciąg w zmiennej o nazwie name. Pobiera również wartość DateTime.Now właściwości, która zawiera bieżący czas lokalny, i przypisuje ją do zmiennej o nazwie currentDate. Zostaną wyświetlone te wartości w oknie konsoli. Na koniec wyświetla monit w oknie konsoli i wywołuje Console.ReadKey(Boolean) metodę oczekiwania na dane wejściowe użytkownika.

   NewLine to niezależny od platformy i niezależny od języka sposób reprezentowania podziału wiersza. Jest taka sama jak \n w języku C#.

   Znak dolara ($) przed ciągiem umożliwia umieszczenie w ciągu wyrażeń, takich jak nazwy zmiennych w nawiasach klamrowych w ciągu. Wartość wyrażenia jest wstawiana do ciągu zamiast wyrażenia. Ta składnia jest określana jako ciągi interpolowane.

3. Zapisz zmiany.

   Ważne

   W programie Visual Studio Code należy jawnie zapisać zmiany. W przeciwieństwie do programu Visual Studio zmiany plików nie są automatycznie zapisywane podczas kompilowanie i uruchamianie aplikacji.

4. Uruchom ponownie program:

   dotnet run
   

5. Odpowiedz na monit, wprowadzając nazwę i naciskając klawisz Enter .

   

6. Naciśnij dowolny klawisz, aby zamknąć program.

Dodatkowe zasoby

• Konfigurowanie programu Visual Studio Code

Następne kroki

W tym samouczku utworzono aplikację konsolową platformy .NET. W następnym samouczku debugujesz aplikację.

Debugowanie aplikacji konsolowej .NET przy użyciu programu Visual Studio Code

W tym samouczku pokazano, jak utworzyć i uruchomić aplikację konsolową platformy .NET przy użyciu programu Visual Studio Code i interfejsu wiersza polecenia platformy .NET. Zadania projektu, takie jak tworzenie, kompilowanie i uruchamianie projektu, są wykonywane przy użyciu interfejsu wiersza polecenia platformy .NET. Jeśli wolisz, możesz wykonać czynności opisane w tym samouczku za pomocą innego edytora kodu i uruchamiać polecenia w terminalu.

Wymagania wstępne

• Program Visual Studio Code z zainstalowanym rozszerzeniem języka C#. Aby uzyskać informacje o sposobie instalowania rozszerzeń w programie Visual Studio Code, zobacz Witryna Marketplace rozszerzenia programu VS Code.
• Zestaw .NET 7 SDK.

Tworzenie aplikacji

Utwórz projekt aplikacji konsolowej platformy .NET o nazwie "HelloWorld".

1. Uruchom program Visual Studio Code.

2. Wybierz pozycję Plik Otwórz folder (Plik>>otwórz... w systemie macOS) z menu głównego.

3. W oknie dialogowym Otwieranie folderu utwórz folder HelloWorld i wybierz go. Następnie kliknij pozycję Wybierz folder (otwórz w systemie macOS).

   Nazwa folderu staje się nazwą projektu i nazwą przestrzeni nazw domyślnie. W dalszej części samouczka dodasz kod, który zakłada, że przestrzeń nazw projektu to HelloWorld.

4. W oknie dialogowym Czy ufasz autorom plików w tym folderze? wybierz pozycję Tak, ufam autorom. Autorom można ufać, ponieważ ten folder zawiera tylko pliki wygenerowane przez platformę .NET i dodane lub zmodyfikowane przez Ciebie.

5. Otwórz terminal w programie Visual Studio Code, wybierając pozycję Wyświetl>terminal z menu głównego.

   Terminal zostanie otwarty z wierszem polecenia w folderze HelloWorld.

6. W terminalu wprowadź następujące polecenie:

   dotnet new console --framework net7.0
   

   Szablon projektu tworzy prostą aplikację, która wyświetla komunikat "Hello, World" w oknie konsoli, wywołując metodę Console.WriteLine(String) w pliku Program.cs.

   Console.WriteLine("Hello, World!");
   

7. Zastąp zawartość pliku Program.cs następującym kodem:

   namespace HelloWorld
   {
       class Program
       {
           static void Main(string[] args)
           {
               Console.WriteLine("Hello, World!");
           }
       }
   }
   

   Podczas pierwszej edycji pliku cs program Visual Studio Code wyświetla monit o dodanie brakujących zasobów w celu skompilowania i debugowania aplikacji. Wybierz pozycję Tak, a program Visual Studio Code tworzy folder vscode z plikami launch.json i tasks.json .

   Uwaga

   Jeśli nie otrzymasz monitu lub przypadkowo go odrzucisz bez wybrania pozycji Tak, wykonaj następujące kroki, aby utworzyć plik launch.json i tasks.json:

   • Wybierz pozycję Uruchom>dodaj konfigurację z menu.
   • Wybierz pozycję .NET 5+ i .NET Core w wierszu polecenia Wybierz środowisko .

   Kod definiuje klasę , Programz pojedynczą metodą , Mainktóra przyjmuje tablicę String jako argument. Main to punkt wejścia aplikacji, metoda wywoływana automatycznie przez środowisko uruchomieniowe podczas uruchamiania aplikacji. Wszystkie argumenty wiersza polecenia podane podczas uruchamiania aplikacji są dostępne w tablicy args .

   W najnowszej wersji języka C# nowa funkcja o nazwie instrukcje najwyższego poziomu pozwala pominąć klasę Program i metodę Main . Większość istniejących programów w języku C# nie używa instrukcji najwyższego poziomu, dlatego w tym samouczku nie jest używana ta nowa funkcja. Ale jest dostępny w języku C# 10 i czy używasz go w programach, jest kwestią preferencji stylu.

Uruchom aplikację

Uruchom następujące polecenie w terminalu:

dotnet run

Program wyświetla tekst "Hello, World!" i kończy się.

Ulepszanie aplikacji

Rozszerz aplikację, aby wyświetlić monit o podanie nazwy użytkownika i wyświetlić go wraz z datą i godziną.

1. Otwórz plik Program.cs.

2. Zastąp zawartość Main metody w pliku Program.cs, czyli wierszem, który wywołuje Console.WriteLinemetodę , następującym kodem:

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   Ten kod wyświetla monit w oknie konsoli i czeka, aż użytkownik wprowadzi ciąg, po którym następuje klawisz Enter . Przechowuje ten ciąg w zmiennej o nazwie name. Pobiera również wartość DateTime.Now właściwości, która zawiera bieżący czas lokalny, i przypisuje ją do zmiennej o nazwie currentDate. Zostaną wyświetlone te wartości w oknie konsoli. Na koniec wyświetla monit w oknie konsoli i wywołuje Console.ReadKey(Boolean) metodę oczekiwania na dane wejściowe użytkownika.

   NewLine to niezależny od platformy i niezależny od języka sposób reprezentowania podziału wiersza. Alternatywy znajdują się \n w języku C# i vbCrLf w Visual Basic.

   Znak dolara ($) przed ciągiem umożliwia umieszczenie w ciągu wyrażeń, takich jak nazwy zmiennych w nawiasach klamrowych w ciągu. Wartość wyrażenia jest wstawiana do ciągu zamiast wyrażenia. Ta składnia jest określana jako ciągi interpolowane.

3. Zapisz zmiany.

   Ważne

   W programie Visual Studio Code należy jawnie zapisać zmiany. W przeciwieństwie do programu Visual Studio zmiany plików nie są automatycznie zapisywane podczas kompilowanie i uruchamianie aplikacji.

4. Uruchom ponownie program:

   dotnet run
   

5. Odpowiedz na monit, wprowadzając nazwę i naciskając klawisz Enter .

   

6. Naciśnij dowolny klawisz, aby zamknąć program.

Dodatkowe zasoby

• Konfigurowanie programu Visual Studio Code

Następne kroki

W tym samouczku utworzono aplikację konsolową platformy .NET. W następnym samouczku debugujesz aplikację.

Debugowanie aplikacji konsolowej .NET przy użyciu programu Visual Studio Code

W tym samouczku pokazano, jak utworzyć i uruchomić aplikację konsolową platformy .NET przy użyciu programu Visual Studio Code i interfejsu wiersza polecenia platformy .NET. Zadania projektu, takie jak tworzenie, kompilowanie i uruchamianie projektu, są wykonywane przy użyciu interfejsu wiersza polecenia platformy .NET. Jeśli wolisz, możesz wykonać czynności opisane w tym samouczku za pomocą innego edytora kodu i uruchamiać polecenia w terminalu.

Wymagania wstępne

• Program Visual Studio Code z zainstalowanym rozszerzeniem języka C#. Aby uzyskać informacje o sposobie instalowania rozszerzeń w programie Visual Studio Code, zobacz Witryna Marketplace rozszerzenia programu VS Code.
• Zestaw .NET 6 SDK.

Tworzenie aplikacji

Utwórz projekt aplikacji konsolowej platformy .NET o nazwie "HelloWorld".

1. Uruchom program Visual Studio Code.

2. Wybierz pozycję Plik Otwórz folder (Plik>>otwórz... w systemie macOS) z menu głównego.

3. W oknie dialogowym Otwieranie folderu utwórz folder HelloWorld i wybierz go. Następnie kliknij pozycję Wybierz folder (otwórz w systemie macOS).

   Nazwa folderu staje się nazwą projektu i nazwą przestrzeni nazw domyślnie. W dalszej części samouczka dodasz kod, który zakłada, że przestrzeń nazw projektu to HelloWorld.

4. W oknie dialogowym Czy ufasz autorom plików w tym folderze? wybierz pozycję Tak, ufam autorom. Autorom można ufać, ponieważ ten folder zawiera tylko pliki wygenerowane przez platformę .NET i dodane lub zmodyfikowane przez Ciebie.

5. Otwórz terminal w programie Visual Studio Code, wybierając pozycję Wyświetl>terminal z menu głównego.

   Terminal zostanie otwarty z wierszem polecenia w folderze HelloWorld.

6. W terminalu wprowadź następujące polecenie:

   dotnet new console --framework net6.0 --use-program-main
   

   Szablon projektu tworzy prostą aplikację, która wyświetla komunikat "Hello, World" w oknie konsoli, wywołując metodę Console.WriteLine(String) w pliku Program.cs.

   namespace HelloWorld;
   
   class Program
   {
       static void Main(string[] args)
       {
           Console.WriteLine("Hello, World!");
       }
   }
   

   Podczas pierwszej edycji pliku cs program Visual Studio Code wyświetla monit o dodanie brakujących zasobów w celu skompilowania i debugowania aplikacji. Wybierz pozycję Tak, a program Visual Studio Code tworzy folder vscode z plikami launch.json i tasks.json .

   Uwaga

   Jeśli nie otrzymasz monitu lub przypadkowo go odrzucisz bez wybrania pozycji Tak, wykonaj następujące kroki, aby utworzyć plik launch.json i tasks.json:

   • Wybierz pozycję Uruchom>dodaj konfigurację z menu.
   • Wybierz pozycję .NET 5+ i .NET Core w wierszu polecenia Wybierz środowisko .

   Kod definiuje klasę , Programz pojedynczą metodą , Mainktóra przyjmuje tablicę String jako argument. Main to punkt wejścia aplikacji, metoda wywoływana automatycznie przez środowisko uruchomieniowe podczas uruchamiania aplikacji. Wszystkie argumenty wiersza polecenia podane podczas uruchamiania aplikacji są dostępne w tablicy args .

   W najnowszej wersji języka C# nowa funkcja o nazwie instrukcje najwyższego poziomu pozwala pominąć klasę Program i metodę Main . Większość istniejących programów w języku C# nie używa instrukcji najwyższego poziomu, dlatego w tym samouczku nie jest używana ta nowa funkcja. Ale jest dostępny w języku C# 10 i czy używasz go w programach, jest kwestią preferencji stylu. W poleceniu użytym dotnet new do utworzenia projektu --use-program-main opcja uniemożliwiła korzystanie z instrukcji najwyższego poziomu.

Uruchom aplikację

Uruchom następujące polecenie w terminalu:

dotnet run

Program wyświetla tekst "Hello, World!" i kończy się.

Ulepszanie aplikacji

Rozszerz aplikację, aby wyświetlić monit o podanie nazwy użytkownika i wyświetlić go wraz z datą i godziną.

1. Otwórz plik Program.cs.

2. Zastąp zawartość Main metody w pliku Program.cs, czyli wierszem, który wywołuje Console.WriteLinemetodę , następującym kodem:

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   Ten kod wyświetla monit w oknie konsoli i czeka, aż użytkownik wprowadzi ciąg, po którym następuje klawisz Enter . Przechowuje ten ciąg w zmiennej o nazwie name. Pobiera również wartość DateTime.Now właściwości, która zawiera bieżący czas lokalny, i przypisuje ją do zmiennej o nazwie currentDate. Zostaną wyświetlone te wartości w oknie konsoli. Na koniec wyświetla monit w oknie konsoli i wywołuje Console.ReadKey(Boolean) metodę oczekiwania na dane wejściowe użytkownika.

   NewLine to niezależny od platformy i niezależny od języka sposób reprezentowania podziału wiersza. Alternatywy znajdują się \n w języku C# i vbCrLf w Visual Basic.

   Znak dolara ($) przed ciągiem umożliwia umieszczenie w ciągu wyrażeń, takich jak nazwy zmiennych w nawiasach klamrowych w ciągu. Wartość wyrażenia jest wstawiana do ciągu zamiast wyrażenia. Ta składnia jest określana jako ciągi interpolowane.

3. Zapisz zmiany.

   Ważne

   W programie Visual Studio Code należy jawnie zapisać zmiany. W przeciwieństwie do programu Visual Studio zmiany plików nie są automatycznie zapisywane podczas kompilowanie i uruchamianie aplikacji.

4. Uruchom ponownie program:

   dotnet run
   

5. Odpowiedz na monit, wprowadzając nazwę i naciskając klawisz Enter .

   

6. Naciśnij dowolny klawisz, aby zamknąć program.

Dodatkowe zasoby

• Konfigurowanie programu Visual Studio Code

Następne kroki

W tym samouczku utworzono aplikację konsolową platformy .NET. W następnym samouczku debugujesz aplikację.

Debugowanie aplikacji konsolowej .NET przy użyciu programu Visual Studio Code