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

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 и поместите в него следующее определение класса:

(window.adrunTag = window.adrunTag || []).push({v: 1, el: 'adrun-4-390', c: 4, b: 390})

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)

  {

    _messageDetails = message;

    CauseOfError = cause;

    ErrorTimeStamp = time;

  }

  // Переопределить свойство Exception.Message.

  public override string Message

    => $"Car Error Message: {_messageDetails}";

}

Здесь класс CarIsDeadException поддерживает закрытое поле (_messageDetails), которое представляет данные, касающиеся текущего исключения; его можно устанавливать с использованием специального конструктора. Сгенерировать такое исключение в методе Accelerate() несложно. Понадобится просто создать, сконфигурировать и сгенерировать объект CarIsDeadException, а не System.Exception:

// Сгенерировать специальное исключение CarIsDeadException.

public void Accelerate(int delta)