Руководство. Создание консольного приложения .NET с помощью Visual Studio Code

В этом учебнике показано, как создать и запустить консольное приложение .NET с помощью Visual Studio Code и .NET CLI. Задачи проекта, такие как создание, компиляция и запуск проекта, выполняются с помощью .NET CLI, поэтому вы можете следовать этому руководству, используя при желании другой редактор кода и выполняя команды в терминале.

Необходимые компоненты

• Установленная платформа Visual Studio Code с расширением C#.

  Если у вас установлено расширение комплекта разработки на C#, удалите или отключите его. Он не используется в этой серии учебников.

  См. сведения об установке расширений Visual Studio Code из Marketplace.

• Пакет SDK для .NET 8.

Создание приложения

Создайте проект консольного приложения .NET с именем HelloWorld.

1. Запустите Visual Studio Code.

2. В главном меню выберите Файл>Открыть папку (в macOS выберите File>Open... (Файл > Открыть)).

3. В диалоговом окне Открыть папку создайте папку HelloWorld и выберите ее. Затем щелкните Выбрать папку (или Открыть в macOS).

   Имя папки по умолчанию преобразуется в имя проекта и имя пространства имен. Вы добавите код позже в этом учебнике. Предполагается, что пространство имен проекта — HelloWorld.

4. В диалоговом окне о доверии авторам файлов в этой папке выберите Да, я доверяю авторам. Вы можете доверять авторам, так как эта папка содержит только файлы, созданные .NET и добавленные или измененные вами.

5. Откройте терминал в Visual Studio Code, выбрав в основном меню пункт Вид>Терминал.

   Откроется окно Терминал с командной строкой в папке HelloWorld.

6. В окне терминала введите следующую команду:

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

   Откройте файл Program.cs, чтобы увидеть простое приложение, созданное шаблоном:

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

   При первом открытии CS-файла Visual Studio Code предложит добавить ресурсы для сборки и отладки приложения. Выберите Да и Visual Studio Code создаст папку .vscode с файлами launch.json и tasks.json.

   Примечание.

   Если запрос не отображается или вы случайно уволите его без нажатия кнопки "Да", сделайте следующее, чтобы создать launch.json и tasks.json:

   • В меню выберите "Выполнить команду "Добавить>конфигурацию".
   • Выберите .NET 5+ и .NET Core в командной строке "Выбор среды ".

   Код определяет класс Program с одним методом Main, который принимает массив String в качестве аргумента. Main — точка входа в приложение. Это метод, который автоматически вызывается средой выполнения при запуске приложения. Все аргументы, предоставленные в командной строке при запуске приложения, доступны через массив args. Код в Main вызове Console.WriteLine(String) метода для отображения сообщения в окне консоли.

   C# имеет функцию с именем операторов верхнего уровня, которая позволяет опустить Program класс и Main метод. В этом руководстве эта функция не используется. Независимо от того, используете ли вы его в программах, это вопрос предпочтения стиля. В команде dotnet new , созданной проектом, --use-program-main параметр не позволил использовать операторы верхнего уровня.

Выполнить приложение

Выполните следующие команды в окне терминала:

dotnet run

Программа отображает "Hello, World!" и заканчивается.

Улучшение приложения

Давайте расширим приложение. Теперь у пользователя будет запрашиваться имя, которое затем будет отображаться с датой и временем.

1. Откройте Program.cs.

2. В Program.cs замените содержимое метода Main (строка, вызывающая Console.WriteLine) следующим кодом:

   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);
   

   Этот код отображает запрос в окне консоли и ожидает, чтобы пользователь ввел строку текста и нажал клавишу ВВОД. Приложение сохраняет полученную строку в переменной с именем name. Оно также получает значение свойства DateTime.Now, которое содержит текущее локальное время, и присваивает его переменной с именем currentDate. Затем оно отображает эти значения в окне консоли. Наконец, приложение выводит запрос в окне консоли и вызывает метод Console.ReadKey(Boolean) для ожидания ввода данных пользователем.

   NewLine — это независимый от платформы и языка способ для представления разрыва строки. Это то же самое, что \n и в C#.

   Знак доллара ($) перед строкой позволяет вставить такие выражения, как имена переменных, в фигурные скобки в строке. Значение выражения вставляется в строку вместо выражения. Такой синтаксис называется интерполированными строками.

3. Сохранение изменений.

   Важно!

   В Visual Studio Code необходимо явно сохранить изменения. В отличие от Visual Studio, изменения файлов не сохраняются автоматически при сборке и запуске приложения.

4. Запустите программу еще раз:

   dotnet run
   

5. В ответ на приглашение в командной строке введите имя и нажмите клавишу ВВОД.

   

6. Нажмите любую клавишу для выхода из программы.

Дополнительные ресурсы

• Настройка Visual Studio Code

Следующие шаги

В этом учебнике показано, как создать консольное приложение .NET. В следующем учебнике описывается отладка приложения.

Отладка консольного приложения .NET с помощью Visual Studio Code

В этом учебнике показано, как создать и запустить консольное приложение .NET с помощью Visual Studio Code и .NET CLI. Задачи проекта, такие как создание, компиляция и запуск проекта, выполняются с помощью .NET CLI, поэтому вы можете следовать этому руководству, используя при желании другой редактор кода и выполняя команды в терминале.

Необходимые компоненты

• Установленная платформа Visual Studio Code с расширением C#. См. сведения об установке расширений Visual Studio Code из Marketplace.
• Пакет SDK для .NET 7.

Создание приложения

Создайте проект консольного приложения .NET с именем HelloWorld.

1. Запустите Visual Studio Code.

2. В главном меню выберите Файл>Открыть папку (в macOS выберите File>Open... (Файл > Открыть)).

3. В диалоговом окне Открыть папку создайте папку HelloWorld и выберите ее. Затем щелкните Выбрать папку (или Открыть в macOS).

   Имя папки по умолчанию преобразуется в имя проекта и имя пространства имен. Вы добавите код позже в этом учебнике. Предполагается, что пространство имен проекта — HelloWorld.

4. В диалоговом окне о доверии авторам файлов в этой папке выберите Да, я доверяю авторам. Вы можете доверять авторам, так как эта папка содержит только файлы, созданные .NET и добавленные или измененные вами.

5. Откройте терминал в Visual Studio Code, выбрав в основном меню пункт Вид>Терминал.

   Откроется окно Терминал с командной строкой в папке HelloWorld.

6. В окне терминала введите следующую команду:

   dotnet new console --framework net7.0
   

   Шаблон проекта создает простое приложение, отображающее "Hello, World" в окне консоли путем вызова Console.WriteLine(String) метода в Program.cs.

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

7. Замените содержимое файла Program.cs кодом, приведенным ниже.

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

   При первом редактировании файла .cs в Visual Studio Code будет предложено добавить недостающие ресурсы для сборки и отладки приложения. Выберите Да и Visual Studio Code создаст папку .vscode с файлами launch.json и tasks.json.

   Примечание.

   Если запрос не отображается или вы случайно уволите его без нажатия кнопки "Да", сделайте следующее, чтобы создать launch.json и tasks.json:

   • В меню выберите "Выполнить команду "Добавить>конфигурацию".
   • Выберите .NET 5+ и .NET Core в командной строке "Выбор среды ".

   Код определяет класс Program с одним методом Main, который принимает массив String в качестве аргумента. Main — точка входа в приложение. Это метод, который автоматически вызывается средой выполнения при запуске приложения. Все аргументы, предоставленные в командной строке при запуске приложения, доступны через массив args.

   В последней версии C# новая используются операторы верхнего уровня, которые позволяют игнорировать класс Program и метод Main. Большинство существующих программ на C# не используют операторы верхнего уровня, поэтому в этом руководстве эта новая функция не используется. Но она доступна в C# 10, и то, используете ли вы ее в своих программах, зависит от стилистических предпочтений.

Выполнить приложение

Выполните следующие команды в окне терминала:

dotnet run

Программа отображает "Hello, World!" и заканчивается.

Улучшение приложения

Давайте расширим приложение. Теперь у пользователя будет запрашиваться имя, которое затем будет отображаться с датой и временем.

1. Откройте Program.cs.

2. В Program.cs замените содержимое метода Main (строка, вызывающая Console.WriteLine) следующим кодом:

   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);
   

   Этот код отображает запрос в окне консоли и ожидает, чтобы пользователь ввел строку текста и нажал клавишу ВВОД. Приложение сохраняет полученную строку в переменной с именем name. Оно также получает значение свойства DateTime.Now, которое содержит текущее локальное время, и присваивает его переменной с именем currentDate. Затем оно отображает эти значения в окне консоли. Наконец, приложение выводит запрос в окне консоли и вызывает метод Console.ReadKey(Boolean) для ожидания ввода данных пользователем.

   NewLine — это независимый от платформы и языка способ для представления разрыва строки. Его альтернативами являются \n в C# и vbCrLf в Visual Basic.

   Знак доллара ($) перед строкой позволяет вставить такие выражения, как имена переменных, в фигурные скобки в строке. Значение выражения вставляется в строку вместо выражения. Такой синтаксис называется интерполированными строками.

3. Сохранение изменений.

   Важно!

   В Visual Studio Code необходимо явно сохранить изменения. В отличие от Visual Studio, изменения файлов не сохраняются автоматически при сборке и запуске приложения.

4. Запустите программу еще раз:

   dotnet run
   

5. В ответ на приглашение в командной строке введите имя и нажмите клавишу ВВОД.

   

6. Нажмите любую клавишу для выхода из программы.

Дополнительные ресурсы

• Настройка Visual Studio Code

Следующие шаги

В этом учебнике показано, как создать консольное приложение .NET. В следующем учебнике описывается отладка приложения.

Отладка консольного приложения .NET с помощью Visual Studio Code

В этом учебнике показано, как создать и запустить консольное приложение .NET с помощью Visual Studio Code и .NET CLI. Задачи проекта, такие как создание, компиляция и запуск проекта, выполняются с помощью .NET CLI, поэтому вы можете следовать этому руководству, используя при желании другой редактор кода и выполняя команды в терминале.

Необходимые компоненты

• Установленная платформа Visual Studio Code с расширением C#. См. сведения об установке расширений Visual Studio Code из Marketplace.
• Пакет SDK для .NET 6.

Создание приложения

Создайте проект консольного приложения .NET с именем HelloWorld.

1. Запустите Visual Studio Code.

2. В главном меню выберите Файл>Открыть папку (в macOS выберите File>Open... (Файл > Открыть)).

3. В диалоговом окне Открыть папку создайте папку HelloWorld и выберите ее. Затем щелкните Выбрать папку (или Открыть в macOS).

   Имя папки по умолчанию преобразуется в имя проекта и имя пространства имен. Вы добавите код позже в этом учебнике. Предполагается, что пространство имен проекта — HelloWorld.

4. В диалоговом окне о доверии авторам файлов в этой папке выберите Да, я доверяю авторам. Вы можете доверять авторам, так как эта папка содержит только файлы, созданные .NET и добавленные или измененные вами.

5. Откройте терминал в Visual Studio Code, выбрав в основном меню пункт Вид>Терминал.

   Откроется окно Терминал с командной строкой в папке HelloWorld.

6. В окне терминала введите следующую команду:

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

   Шаблон проекта создает простое приложение, отображающее "Hello, World" в окне консоли путем вызова Console.WriteLine(String) метода в Program.cs.

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

   При первом редактировании файла .cs в Visual Studio Code будет предложено добавить недостающие ресурсы для сборки и отладки приложения. Выберите Да и Visual Studio Code создаст папку .vscode с файлами launch.json и tasks.json.

   Примечание.

   Если запрос не отображается или вы случайно уволите его без нажатия кнопки "Да", сделайте следующее, чтобы создать launch.json и tasks.json:

   • В меню выберите "Выполнить команду "Добавить>конфигурацию".
   • Выберите .NET 5+ и .NET Core в командной строке "Выбор среды ".

   Код определяет класс Program с одним методом Main, который принимает массив String в качестве аргумента. Main — точка входа в приложение. Это метод, который автоматически вызывается средой выполнения при запуске приложения. Все аргументы, предоставленные в командной строке при запуске приложения, доступны через массив args.

   В последней версии C# новая используются операторы верхнего уровня, которые позволяют игнорировать класс Program и метод Main. Большинство существующих программ на C# не используют операторы верхнего уровня, поэтому в этом руководстве эта новая функция не используется. Но она доступна в C# 10, и то, используете ли вы ее в своих программах, зависит от стилистических предпочтений. В команде dotnet new , используемой для создания проекта, --use-program-main параметр не позволил использовать операторы верхнего уровня.

Выполнить приложение

Выполните следующие команды в окне терминала:

dotnet run

Программа отображает "Hello, World!" и заканчивается.

Улучшение приложения

Давайте расширим приложение. Теперь у пользователя будет запрашиваться имя, которое затем будет отображаться с датой и временем.

1. Откройте Program.cs.

2. В Program.cs замените содержимое метода Main (строка, вызывающая Console.WriteLine) следующим кодом:

   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);
   

   Этот код отображает запрос в окне консоли и ожидает, чтобы пользователь ввел строку текста и нажал клавишу ВВОД. Приложение сохраняет полученную строку в переменной с именем name. Оно также получает значение свойства DateTime.Now, которое содержит текущее локальное время, и присваивает его переменной с именем currentDate. Затем оно отображает эти значения в окне консоли. Наконец, приложение выводит запрос в окне консоли и вызывает метод Console.ReadKey(Boolean) для ожидания ввода данных пользователем.

   NewLine — это независимый от платформы и языка способ для представления разрыва строки. Его альтернативами являются \n в C# и vbCrLf в Visual Basic.

   Знак доллара ($) перед строкой позволяет вставить такие выражения, как имена переменных, в фигурные скобки в строке. Значение выражения вставляется в строку вместо выражения. Такой синтаксис называется интерполированными строками.

3. Сохранение изменений.

   Важно!

   В Visual Studio Code необходимо явно сохранить изменения. В отличие от Visual Studio, изменения файлов не сохраняются автоматически при сборке и запуске приложения.

4. Запустите программу еще раз:

   dotnet run
   

5. В ответ на приглашение в командной строке введите имя и нажмите клавишу ВВОД.

   

6. Нажмите любую клавишу для выхода из программы.

Дополнительные ресурсы

• Настройка Visual Studio Code

Следующие шаги

В этом учебнике показано, как создать консольное приложение .NET. В следующем учебнике описывается отладка приложения.

Отладка консольного приложения .NET с помощью Visual Studio Code