Язык программирования C#9 и платформа .NET5

// Возвратить произвольный код ошибки.

return -1;

Если программа в качестве точки входа по-прежнему использует метод Main(), то вот как изменить сигнатуру метода, чтобы возвращать int вместо void:

static int Main()

{

   …

}

Теперь давайте захватим возвращаемое значение программы с помощью пакетного файла. Используя проводник Windows, перейдите в папку, где находится файл решения (например, С:\SimpleCSharpApp), и создайте в ней новый текстовый файл (по имени SimpleCSharpApp.cmd). Поместите в файл приведенные далее инструкции (если раньше вам не приходилось создавать файлы *.cmd, то можете не беспокоиться о деталях):

@echo off

rem Пакетный файл для приложения SimpleCSharpApp.exe,

rem в котором захватывается возвращаемое им значение.

dotnet run

@if "%ERRORLEVEL%" == "0" goto success

:fail

  echo This application has failed!

  echo return value = %ERRORLEVEL%

  goto end

:success

  echo This application has succeeded!

  echo return value = %ERRORLEVEL%

  goto end

:end

echo All Done.

Откройте окно командной подсказки (или терминал VSC) и перейдите в папку, содержащую новый файл *.cmd. Запустите его, набрав имя и нажав <Enter>. Вы должны получить показанный ниже вывод, учитывая, что операторы верхнего уровня или метод Main() возвращает -1. Если бы возвращалось значение 0, то вы увидели бы в окне консоли сообщение This application has succeeded!

***** My First C# App *****

Hello World!

This application has failed!

return value = -1

All Done.

Ниже приведен сценарий PowerShell, который эквивалентен предыдущему сценарию в файле *.cmd:

dotnet run

if ($LastExitCode -eq 0) {

  Write-Host "This application has succeeded!"

} else

{

  Write-Host "This application has failed!"

}

Write-Host "All Done."

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

.\SimpleCSharpApp.psl

Вот что вы увидите в терминальном окне:

***** My First C# App *****

Hello World!

This application has failed!

All Done.

В подавляющем большинстве приложений C# (если только не во всех) в качестве возвращаемого значения будет применяться void, что подразумевает неявное возвращение нулевого кода ошибки. Таким образом, все методы Main() или операторы верхнего уровня в этой книге (кроме текущего примера) будут возвращать void.

Обработка аргументов командной строки

Теперь, когда вы лучше понимаете, что собой представляет возвращаемое значение метода Main() или операторов верхнего уровня, давайте посмотрим на входной массив строковых данных. Предположим, что приложение необходимо модифицировать для обработки любых возможных параметров командной строки. Один из способов предусматривает применение цикла for языка С#. (Все итерационные конструкции языка C# более подробно рассматриваются в конце главы.)

// Вывести сообщение и ожидать нажатия клавиши .

Console.WriteLine("***** My First C# App *****");

Console.WriteLine("Hello World!");

Console.WriteLine();

// Обработать любые входные аргументы.

for (int i = 0; i < args.Length; i++)

{

  Console.WriteLine("Arg: {0}", args[i]);

}

Console.ReadLine();

// Возвратить произвольный код ошибки,

return 0;

На заметку! В этом примере применяются операторы верхнего уровня, т.е. метод Main() не задействован. Вскоре будет показано, как обновить метод Main(), чтобы он принимал параметр args.

Снова загляните в код IL, который сгенерирован для программы, использующей операторы верхнего уровня. Обратите внимание, что метод

$

принимает строковый массив по имени args, как видно ниже (для экономии пространства код приведен с сокращениями):

.class private abstract auto ansi sealed beforefieldinit '$'

       extends [System.Runtime]System.Object

{