Эндрю Троелсен - ЯЗЫК ПРОГРАММИРОВАНИЯ С# 2005 И ПЛАТФОРМА .NET 2.0. 3-е издание

Стек: at SimpleException.Car.Accelerate(Int32 delta)

in с:\myаррs\exceptions\car.cs: line 65

at Exceptions.App.Main()

in с:\myapps\exceptions\app.cs: line 21

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

Свойства Target Site и StackTrace позволяют получить информацию о данном исключении программисту, но конечному пользователю эта информация мало что дает. Вы уже видели, что для получения информации, понятной обычному пользователю, можно использовать свойство System.Exception.Message. В дополнение к этому свойство HelpLink может указать адрес URL или стандартный файл справки Windows, содержащий более подробную информацию.

По умолчанию значением свойства HelpLink является пустая строка. Чтобы присвоить этому свойству некоторое значение, вы должны сделать это перед тем, как будет сгенерирован тип System.Exception. Вот как можно соответствующим образом изменить метод Car.Accelerate().

public void Accelerate(int delta) {

if (carIsDead) Console.WriteLine("{0) не работает…", petName);

else {

currSpeed += delta;

if (currSpeed ›= maxSpeed) {

carIsDead = true;

currSpeed = 0;

// Чтобы вызвать свойство HelpLink, перед оператором,

// генерирующим объект Exception, создается локальная переменная.

Exception ex = new Exception(string.Format("{0} перегрелся!", petName));

ex.HelpLink = "http://www.CarsRUs.com";

throw ex;

} else Console.WriteLine("=› CurrSpeed = {0}", currSpeed);

}

}

Логику catch теперь можно изменить, чтобы информация ссылки выводилась так, как показано ниже.

catch(Exception e) {

…

Console.WriteLine("Соответствующая справка: {0}", e.HelpLink);

}

Свойство Data объекта System.Exception является новым в .NET 2.0 и позволяет добавить в объект исключения дополнительную информацию для пользователя (например, штамп времени или что-то другое). Свойство Data возвращает объект, реализующий интерфейс с именем IDictionary, определенный в пространстве имен System.Collection. Роль программирования интерфейсов, как и пространство имен System.Collection, рассматриваются в следующей главе. Сейчас же будет достаточно заметить, что коллекции словарей позволяют создавать множества значений, возвращаемых по значению ключа. Рассмотрите, например, следующую модификацию метода Car.Accelerate().

public void Accelerate(int delta) {

if (carIsDead) Console.WriteLine("{0} не работает…", petName);

else {

currSpeed += delta;

if (currSpeed ›= maxSpeed) {

carIsDead = true;

currSpeed = 0;

// Чтобы вызвать свойство HelpLink, перед оператором,

// генерирующим объект Exception, создается локальная переменная.

Exception ex = new Exception(string.Format("{0} перегрелся!", petName));

ex.HelpLink = "http://www.CarsRUs.com";

// Место для пользовательских данных с описанием ошибки.

ex.Data.Add("Дата и время", string.Format("Автомобиль сломался {0}", DateTime.Now));

ex.Data.Add("Причина", " У вас тяжелая нога");

throw ex;

} else Console.WriteLine("=› CurrSpeed = {0}", currSpeed);

}

}

Чтобы не возникло проблем при определении пар "ключ-значение", с помощью директивы using следует указать пространство имен System.Collection, поскольку в файле, содержащем класс с реализацией метода Main(), мы собираемся использовать тип DictionaryEntry.

using System.Collections;

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

catch (Exception e) {

…

// По умолчанию поле данных пусто, поэтому проверяем на null.

Console.WriteLine("\n-› Пользовательские данные:");

if (e.Data != null) {

foreach (DictionaryEntry de in e.Data) Console.WriteLine("-› {0}; {1}", de.Key, de.Value);

}

}

С этими изменениями мы должны получить вывод, показанный на рис. 6.4.

Рис. 6.4. Получение пользовательских данных

Исходный код.Проект SimpleException размещен в подкаталоге, соответствующем главе 6.