Книга: ЯЗЫК ПРОГРАММИРОВАНИЯ С# 2005 И ПЛАТФОРМА .NET 2.0. 3-е издание

Свойство HelpLink

Свойство HelpLink

Свойства 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);
}

Оглавление книги