Язык программирования C#9 и платформа .NET5 - Эндрю Троелсен

static int Main()

{

  // Перед выходом должен возвращать значение!

  return 0;

}

С выходом версии С# 7.1 метод Main() может быть асинхронным. Асинхронное программирование раскрывается в главе 15, но теперь важно помнить о существовании четырех дополнительных сигнатур:

static Task Main()

static Task<int> Main()

static Task Main(string[])

static Task<int> Main(string[])

На заметку! Метод Main() может быть также определен как открытый в противоположность закрытому, что подразумевается, если конкретный модификатор доступа не указан. Среда Visual Studio определяет метод Main() как неявно закрытый. Модификаторы доступа подробно раскрываются в главе 5.

Очевидно, что выбор способа создания метода 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: <Program>$  (02000002)

//   Flags     : [NotPublic] [AutoLayout] [Class] [Abstract] [Sealed] [AnsiClass]

     [BeforeFieldInit]  (00100180)

//   Extends   : 0100000D [TypeRef] System.Object

//   Method #1 (06000001) [ENTRYPOINT]

//   -------------------------------------------------------

//          MethodName: <Main>$ (06000001)

Сравните его с определением TypeDef для точки входа в главе 1:

// -------------------------------------------------------

// TypDefName: CalculatorExamples.Program  (02000002)

//   Flags     : [NotPublic] [AutoLayout] [Class] [AnsiClass]

     [BeforeFieldInit]  (00100000)

//   Extends   : 0100000C [TypeRef] System.Object

//   Method #1 (06000001) [ENTRYPOINT]

//   -------------------------------------------------------

//          MethodName: Main (06000001)

В примере из главы 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 запущенного процесса.

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

// Обратите внимание, что теперь возвращается int, а не void.

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

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

Console.WriteLine("Hello World!");

Console.WriteLine();

Console.ReadLine();

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

return -1;

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

static int Main()

{

   …

}

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

@echo off

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

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

dotnet run

@if "%ERRORLEVEL%" ==