Предизвикване (хвърляне) на изключения

Собствени изключения – пример

Понеже всички инстанции на ParseFileException се създават чрез извикване (директно или инди­ректно) на базовия конструктор на класа ApplicationException, то при подаване на изключение-причинител, то ще бъде записано в свойството InnerException, което се наследява от класа System.Exception. По същия начин подаденото текстово описание на проблема ще се запише в наследеното свойство Message.

Ето как изключението ParseFileException може да бъде използвано в програма, която по даден текстов файл, съдържащ цели числа (по 1 на ред), намира тяхната сума:

static long CalculateSumOfLines(string aFileName) { StreamReader inF; try { inF = File.OpenText(aFileName); } catch (IOException ioe) { throw new ParseFileException(String.Format( "Can not open the file {0} for reading.", aFileName), aFileName, ioe); } try { long sum = 0; long lineNumber = 0; while (true) { lineNumber++; string line; try { line = inF.ReadLine(); } catch (IOException ioe) { throw new ParseFileException( "Error reading from file.", aFileName, lineNumber, ioe); } if (line == null) break; // end of file reached try { sum += Int32.Parse(line); } catch (SystemException se) { throw new ParseFileException(String.Format( "Error parsing line '{0}'.", line), aFileName, lineNumber, se); } } return sum; } finally { inF.Close(); } } static void Main() { try { long sumOfLines = CalculateSumOfLines(@"c:\test.txt"); Console.WriteLine("The sum of lines={0}", sumOfLines); } catch (ParseFileException pfe) { Console.WriteLine("File name: {0}", pfe.FileName); Console.WriteLine("Line number: {0}", pfe.LineNumber); Console.WriteLine("Exception: {0}", pfe); } }

В примера при възникване на проблем при четенето от файла или с формата на данните, прочетени от него, се хвърля изключението ParseFileException. В него се задава подходящо съобщение за грешка, записват се името на файла, номерът на реда, където е възникнал проблема, и изключението-причи­нител на проблема.

Ако стартираме приложението в момент, в който файлът c:\test.txt липсва, ще получим следния резултат:

File name: c:\test.txt Line number: 0 Exception: ParseFileException: Can not open the file c:\test.txt for reading. ---> System.IO.FileNotFoundException: Could not find file "c:\test.txt". File name: "c:\test.txt" at System.IO.__Error.WinIOError(Int32 errorCode, String str) at System.IO.FileStream..ctor(String path, FileMode mode, FileAccess access, FileShare share, Int32 bufferSize, Boolean useAsync, String msgPath, Boolean bFromProxy) at System.IO.FileStream..ctor(String path, FileMode mode, FileAccess access, FileShare share, Int32 bufferSize) at System.IO.StreamReader..ctor(String path, Encoding encoding, Boolean detectEncodingFromByteOrderMarks, Int32 bufferSize) at System.IO.StreamReader..ctor(String path) at System.IO.File.OpenText(String path) at Test.CalculateSumOfLines(String aFileName) in c:\demos\ParseFileExceptionDemo.cs:line 52 --- End of inner exception stack trace --- at Test.CalculateSumOfLines(String aFileName) in c:\demos\ParseFileExceptionDemo.cs:line 56 at Test.Main() in c:\demos\ParseFileExceptionDemo.cs:line 106

Както се вижда, възникнало е изключение ParseFileException, а причи­ната за него е изключението System.IO.FileNotFoundException.

Съхраняването на началната причина за възникване на изключението при пода­ване на изключение от по-високо ниво на абстракция (както в горния пример) е добра практика, защото дава на разработчика по-богата инфор­мация за възникналия проблем.

В примера изключението ParseFileException е от по-високо ниво на абстракция, отколкото FileNotFoundException и дава по-богата информа­ция на разработчика.