Очевидно, что выбор способа создания метода
Main()
зависит от ответов на три вопроса. Первый вопрос: нужно ли возвращать значение системе, когда метод
Main()
заканчивается и работа программы завершается? Если да, тогда необходимо возвращать тип данных
int
, а не
void
. Второй вопрос: требуется ли обрабатывать любые предоставляемые пользователем параметры командной строки? Если да, то они будут сохранены в массиве строк. Наконец, третий вопрос: есть ли необходимость вызывать асинхронный код в методе
Main()
? Ниже мы более подробно обсудим первые два варианта, а исследование третьего отложим до главы 15.
Использование операторов верхнего уровня (нововведение в версии 9.0)
Хотя и верно то, что до выхода версии C# 9.0 все приложения .NET Core на языке C# обязаны были иметь метод
Main()
, в C# 9.0 появились операторы верхнего уровня, которые устраняют необходимость в большей части формальностей, связанных с точкой входа в приложение С#. Вы можете избавиться как от класса (
Program
), так и от метода
Main()
. Чтобы взглянуть на это в действии, приведите содержимое файла
Program.cs
к следующему виду:
using System;
// Отобразить пользователю простое сообщение.
Console.WriteLine(***** Му First C# Арр *****);
Console.WriteLine("Hello World!");
Console.WriteLine();
// Ожидать нажатия клавиши <Enter>, прежде чем завершить работу.
Console.ReadLine();
Запустив программу, вы увидите, что получается тот же самый результат! Существует несколько правил применения операторов верхнего уровня.
• Операторы верхнего уровня можно использовать только в одном файле внутри приложения.
• В случае применения операторов верхнего уровня программа не может иметь объявленную точку входа.
• Операторы верхнего уровня нельзя помещать в пространство имен.
• Операторы верхнего уровня по-прежнему имеют доступ к строковому массиву аргументов.
• Операторы верхнего уровня возвращают код завершения приложения (как объясняется в следующем разделе) с использованием
return
.
• Функции, которые объявлялись в классе
Program
, становятся локальными функциями для операторов верхнего уровня. (Локальные функции раскрываются в главе 4.)
• Дополнительные типы можно объявлять после всех операторов верхнего уровня. Объявление любых типов до окончания операторов верхнего уровня приводит к ошибке на этапе компиляции.
"За кулисами" компилятор заполняет пробелы. Исследуя сгенерированный код IL для обновленного кода, вы заметите такое определение
TypeDef
для точки входа в приложение:
// TypeDef #1 (02000002)
// -------------------------------------------------------
// TypDefName: <b><Program>$</b> (02000002)
// Flags : [NotPublic] [AutoLayout] [Class] [Abstract] [Sealed] [AnsiClass]
[BeforeFieldInit] (00100180)
// Extends : 0100000D [TypeRef] System.Object
// Method #1 (06000001) [ENTRYPOINT]
// -------------------------------------------------------
// <b>MethodName: <Main>$ (06000001)</b>
Сравните его с определением
TypeDef
для точки входа в главе 1:
// -------------------------------------------------------
// TypDefName: <b>CalculatorExamples.Program</b> (02000002)
// Flags : [NotPublic] [AutoLayout] [Class] [AnsiClass]
[BeforeFieldInit] (00100000)
// Extends : 0100000C [TypeRef] System.Object
// Method #1 (06000001) [ENTRYPOINT]
// -------------------------------------------------------
// <b>MethodName: Main (06000001)</b>
В примере из главы 1 обратите внимание, что значение
TypDefName
представлено как пространство имен (
CalculatorExamples
) плюс имя класса (
Program
), а значением
MethodName
является
Main
. В обновленном примере, использующем операторы верхнего уровня, компилятор заполняется значение
<Program>$
для
TypDefName
и значение
<Main>$
для имени метода.
Указание кода ошибки приложения (обновление в версии 9.0)
Хотя в подавляющем большинстве случаев методы
Main()
или операторы верхнего уровня будут иметь
void
в качестве возвращаемого значения, возможность возвращения
int
(или
Task<int>
) сохраняет согласованность C# с другими языками, основанными на С. По соглашению возврат значения
0
указывает на то, что программа завершилась успешно, тогда как любое другое значение (вроде
-1
) представляет условие ошибки (имейте в виду, что значение
0
автоматически возвращается даже в случае, если метод
Main()
прототипирован как возвращающий
void
).
При использовании операторов верхнего уровня (следовательно, в отсутствие метода
Main()
) в случае, если исполняемый код возвращает целое число, то оно и будет кодом возврата. Если же явно ничего не возвращается, тогда все равно обеспечивается возвращение значения
0
, как при явном применении метода
Main()
.
В ОС Windows возвращаемое приложением значение сохраняется в переменной среды по имени
%ERRORLEVEL%
. Если создается приложение, которое программно запускает другой исполняемый файл (тема, рассматриваемая в главе 19), тогда получить значение
%ERRORLEVEL%
можно с применением свойства
ExitCode
запущенного процесса.
