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

        }

      };

    }

    Console.WriteLine("=> CurrentSpeed = {0}", CurrentSpeed);

  }

}

С целью успешного прохода по парам "ключ-значение" добавьте директиву using для пространства имен System.Collections, т.к. в файле с операторами верхнего уровня будет применяться тип DictionaryEntry:

using System.Collections;

Затем обновите логику в блоке catch, чтобы обеспечить проверку значения, возвращаемого из свойства Data, на равенство null (т.е. стандартному значению). После этого свойства Key и Value типа DictionaryEntry используются для вывода специальных данных на консоль:

catch (Exception e)

{

  ...

  Console.WriteLine("n-> Custom Data:");

  foreach (DictionaryEntry de in e.Data)

  {

    Console.WriteLine("-> {0}: {1}", de.Key, de.Value);

  }

}

Вот как теперь выглядит финальный вывод программы:

***** Simple Exception Example *****

=> Creating a car and stepping on it!

Jamming...

=> CurrentSpeed = 30

=> CurrentSpeed = 40

=> CurrentSpeed = 50

=> CurrentSpeed = 60

=> CurrentSpeed = 70

=> CurrentSpeed = 80

=> CurrentSpeed = 90

*** Error! ***

Member name: Void Accelerate(Int32)

Class defining member: SimpleException.Car

Member type: Method

Message: Zippy has overheated!

Source: SimpleException

Stack: at SimpleException.Car.Accelerate(Int32 delta) ...

       at SimpleException.Program.Main(String[] args) ...

Help Link: http://www.CarsRUs.com

-> Custom Data:

-> TimeStamp: The car exploded at 3/15/2020 16:22:59

-> Cause: You have a lead foot.

***** Out of exception logic *****

Свойство Data удобно в том смысле, что оно позволяет упаковывать специальную информацию об ошибке, не требуя построения нового типа класса для расширения базового класса Exception. Тем не менее, каким бы полезным ни было свойство Data, разработчики все равно обычно строят строго типизированные классы исключений, которые поддерживают специальные данные, применяя строго типизированные свойства.

Такой подход позволяет вызывающему коду перехватывать конкретный тип, производный от 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

  {

  }

}

Как и с любым классом, вы можете создавать произвольное количество специальных членов, к