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

Такой подход позволяет вызывающему коду перехватывать конкретный тип, производный от Exception, а не углубляться в коллекцию данных с целью получения дополнительных деталей. Чтобы понять, как это работает, необходимо разобраться с разницей между исключениями уровня системы и уровня приложения.

Исключения уровня системы (System.SystemException)

В библиотеках базовых классов .NET 5 определено много классов, которые в конечном итоге являются производными от System.Exception.

Например, в пространстве имен System определены основные объекты исключений, такие как ArgumentOutOfRangeException, IndexOutOfRangeException, StackOverflowException и т.п. В других пространствах имен есть исключения, которые отражают поведение этих пространств имен. Например, в System.Drawing.Printing определены исключения, связанные с печатью, в System.IO — исключения, возникающие во время ввода-вывода, в System.Data — исключения, специфичные для баз данных, и т.д.

Исключения, которые генерируются самой платформой .NET 5, называются системными исключениями. Такие исключения в общем случае рассматриваются как неисправимые фатальные ошибки. Системные исключения унаследованы прямо от базового класса System.SystemException, который в свою очередь порожден от System.Exception (а тот — от класса System.Object):

 public class SystemException : Exception
 {
  // Various constructors.
 }

Учитывая, что тип System.SystemException не добавляет никакой дополнительной функциональности кроме набора специальных конструкторов, вас может интересовать, по какой причине он вообще существует. Попросту говоря, когда тип исключения является производным от System.SystemException, то есть возможность выяснить, что исключение сгенерировала исполняющая среда .NET 5, а не кодовая база выполняющегося приложения. Это довольно легко проверить, используя ключевое слово is:

 // Верно! NullReferenceException является SystemException.
 NullReferenceException nullRefEx = new NullReferenceException;
 Console.WriteLine(
  "NullReferenceException is-a SystemException? : {0}",
  nullRefEx is SystemException);

Исключения уровня приложения (Systern.ApplicationException)

Поскольку все исключения .NET 5 являются типами классов, вы можете создавать собственные исключения, специфичные для приложения. Однако из-за того, что базовый класс System.SystemException представляет исключения, генерируемые исполняющей средой, может сложиться впечатление, что вы должны порождать свои специальные исключения от типа System.Exception. Конечно, можно поступать и так, но взамен их лучше наследовать от класса System.ApplicationException:

 public class ApplicationException : Exception
 {
  // Разнообразные конструкторы.
 }

Как и в SystemException, кроме набора конструкторов никаких дополнительных членов в классе ApplicationException не определено. С точки зрения функциональности единственная цель класса System.ApplicationException состоит в идентификации источника ошибки. При обработке исключения, производного от System.ApplicationException, можно предполагать, что исключение было сгенерировано кодовой базой выполняющегося приложения, а не библиотеками базовых классов .NET Core либо исполняющей средой .NET 5.

Построение специальных исключений, способ первый

Наряду с тем, что для сигнализации об ошибке во время выполнения можно всегда генерировать экземпляры System.Exception (как было показано в первом примере), иногда предпочтительнее создавать строго типизированное исключение, которое представляет уникальные детали, связанные с текущей проблемой.

Например, предположим, что вы хотите построить специальное исключение (по имени CarIsDeadException) для представления ошибки, которая возникает из-за увеличения скорости обреченного на выход из строя автомобиля. Первым делом создается новый класс, унаследованный от System.Exception/System.ApplicationException (по соглашению имена всех классов исключений заканчиваются суффиксом Exception).

На заметку! Согласно правилу все специальные классы исключений должны быть определены как открытые (вспомните, что стандартным модификатором доступа для невложенных типов является internal). Причина в том, что исключения часто передаются за границы сборок и потому должны быть доступны вызывающей кодовой базе.

Создайте новый проект консольного приложения по имени CustomException, скопируйте в него предыдущие файлы Car.cs и Radio.cs и измените название пространства имен, в котором определены типы Car и Radio, с SimpleException на CustomException.

Затем добавьте в проект новый файл по имени CarIsDeadException.cs и поместите в него следующее определение класса:

 using System;
 namespace CustomException
 {
  // Это специальное исключение описывает детали условия
  // выхода автомобиля из строя .
  // (Не забывайте, что можно также просто расширить класс Exception.)
  public class CarIsDeadException : ApplicationException
  {
  }
 }

Как и с любым классом, вы можете создавать произвольное количество специальных членов, к которым можно обращаться внутри блока catch в вызывающем коде. Кроме того, вы можете также переопределять любые виртуальные члены, определенные в родительских классах. Например, вы могли бы реализовать CarIsDeadException, переопределив виртуальное свойство Message.

Вместо заполнения словаря данных (через свойство Data) при генерировании исключения конструктор позволяет указывать отметку времени и причину возникновения ошибки Наконец, отметку времени и причину возникновения ошибки можно получить с применением строго типизированных свойств:

 public class CarIsDeadException : ApplicationException
 {
  private string _messageDetails = String.Empty;
  public DateTime ErrorTimeStamp {get; set;}
  public string CauseOfError {get; set;}
  public CarIsDeadException{}
  public CarIsDeadException(string message,
  string cause, DateTime time)
  {