"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# более подробно рассматриваются в конце главы.)
// Вывести сообщение и ожидать нажатия клавиши <Enter>.
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, который сгенерирован для программы, использующей операторы верхнего уровня. Обратите внимание, что метод <Main>$ принимает строковый массив по имени args, как видно ниже (для экономии пространства код приведен с сокращениями):
.class private abstract auto ansi sealed beforefieldinit '<Program>$'
extends [System.Runtime]System.Object
{
.custom instance void [System.Runtime]System.Runtime.CompilerServices.
CompilerGeneratedAttribute::.ctor()=
( 01 00 00 00 )
.method private hidebysig static
void '<Main>$'(string[] args) cil managed
{
.entrypoint
...
} // end of method '<Program>$'::'<Main>$'
} // end of class '<Program>$'
Если в программе в качестве точки входа по-прежнему применяется метод Main(), тогда обеспечьте, чтобы сигнатура метода принимала строковый массив по имени args:
static int Main(string[] args)
{
...
}
Здесь с использованием свойства Length класса System.Array производится проверка, есть ли элементы в массиве строк. Как будет показано в главе 4, все массивы C# фактически являются псевдонимом класса System.Array и потому разделяют общий набор членов. По мере прохода в цикле по элементам массива их значения выводятся на консоль. Предоставить аргументы в командной строке в равной степени просто:
C:SimpleCSharpApp>dotnet run /arg1 -arg2
***** My First C# App *****
Hello World!
Arg: /arg1
Arg: -arg2
Вместо стандартного цикла for для реализации прохода по входному строковому массиву можно также применять ключевое слово foreach. Вот пример использования foreach (особенности конструкций циклов обсуждаются далее в главе):
// Обратите внимание, что в случае применения foreach
// отпадает необходимость в проверке размера массива.
foreach(string arg in args)
{
Console.WriteLine("Arg: {0}", arg);
}
Console.ReadLine();
return 0;
Наконец, доступ к аргументам командной строки можно также получать с помощью статического метода GetCommandLineArgs() типа System.Environment. Данный метод возвращает массив элементов string. Первый элемент содержит имя самого приложения, а остальные — индивидуальные аргументы командной строки. Обратите внимание, что при таком подходе больше не обязательно определять метод Main() как принимающий массив string во входном параметре, хотя никакого вреда от этого не будет.
// Получить аргументы с использованием System.Environment.
string[] theArgs = Environment.GetCommandLineArgs();
foreach(string arg in theArgs)
{
Console.WriteLine("Arg: {0}", arg);
}
Console.ReadLine();
return 0;
На заметку! Метод GetCommandLineArgs() не получает аргументы для приложения через метод Main() и не полагается на параметр string[] args.
Разумеется, именно на вас возлагается решение о том, на какие аргументы командной строки должна реагировать программа (если они вообще будут предусмотрены), и как они должны быть сформатированы (например, с префиксом - или /). В показанном выше коде мы просто передаем последовательность аргументов, которые выводятся прямо в окно командной строки. Однако предположим, что создается новое игровое приложение, запрограммированное на обработку параметра вида -godmode. Когда пользователь запускает приложение с таким флагом, в отношении него можно было бы предпринять соответствующие действия.
Указание аргументов командной строки в Visual Studio
В реальности конечный пользователь при запуске программы имеет возможность предоставлять аргументы командной строки. Тем не менее, указывать допустимые флаги командной строки также может требоваться во время разработки в целях тестирования программы. Чтобы сделать это в Visual Studio, щелкните правой кнопкой на имени проекта в окне Solution Explorer, выберите в контекстном меню пункт Properties (Свойства),
