Exception Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет ошибки, которые происходят во время выполнения приложения.
public ref class Exceptionpublic ref class Exception : System::Runtime::Serialization::ISerializablepublic ref class Exception : System::Runtime::InteropServices::_Exception, System::Runtime::Serialization::ISerializablepublic class Exceptionpublic class Exception : System.Runtime.Serialization.ISerializable[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDual)]
[System.Serializable]
public class Exception : System.Runtime.Serialization.ISerializable[System.Serializable]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.ComVisible(true)]
public class Exception : System.Runtime.InteropServices._Exception, System.Runtime.Serialization.ISerializable[System.Serializable]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.ComVisible(true)]
public class Exception : System.Runtime.Serialization.ISerializabletype Exception = classtype Exception = class
interface ISerializable[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDual)>]
[<System.Serializable>]
type Exception = class
interface ISerializable[<System.Serializable>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Exception = class
interface ISerializable
interface _Exception[<System.Serializable>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Exception = class
interface ISerializablePublic Class ExceptionPublic Class Exception
Implements ISerializablePublic Class Exception
Implements _Exception, ISerializable- Наследование
-
Exception
- Производный
- Атрибуты
- Реализации
Примеры
В следующем примере демонстрируется catch блок (with в F#), определенный для обработки ArithmeticException ошибок. Этот catch блок также перехватывает DivideByZeroException ошибки, так как DivideByZeroException является производным от ArithmeticException и для ошибок явно не catch определен DivideByZeroException блок.
using namespace System;
int main()
{
int x = 0;
try
{
int y = 100 / x;
}
catch ( ArithmeticException^ e )
{
Console::WriteLine( "ArithmeticException Handler: {0}", e );
}
catch ( Exception^ e )
{
Console::WriteLine( "Generic Exception Handler: {0}", e );
}
}
/*
This code example produces the following results:
ArithmeticException Handler: System.DivideByZeroException: Attempted to divide by zero.
at main()
*/
using System;
class ExceptionTestClass
{
public static void Main()
{
int x = 0;
try
{
int y = 100 / x;
}
catch (ArithmeticException e)
{
Console.WriteLine($"ArithmeticException Handler: {e}");
}
catch (Exception e)
{
Console.WriteLine($"Generic Exception Handler: {e}");
}
}
}
/*
This code example produces the following results:
ArithmeticException Handler: System.DivideByZeroException: Attempted to divide by zero.
at ExceptionTestClass.Main()
*/
module ExceptionTestModule
open System
let x = 0
try
let y = 100 / x
()
with
| :? ArithmeticException as e ->
printfn $"ArithmeticException Handler: {e}"
| e ->
printfn $"Generic Exception Handler: {e}"
// This code example produces the following results:
// ArithmeticException Handler: System.DivideByZeroException: Attempted to divide by zero.
// at <StartupCode$fs>.$ExceptionTestModule.main@()
Class ExceptionTestClass
Public Shared Sub Main()
Dim x As Integer = 0
Try
Dim y As Integer = 100 / x
Catch e As ArithmeticException
Console.WriteLine("ArithmeticException Handler: {0}", e.ToString())
Catch e As Exception
Console.WriteLine("Generic Exception Handler: {0}", e.ToString())
End Try
End Sub
End Class
'
'This code example produces the following results:
'
'ArithmeticException Handler: System.OverflowException: Arithmetic operation resulted in an overflow.
' at ExceptionTestClass.Main()
'
Комментарии
Этот класс является базовым для всех исключений. При возникновении ошибки система или выполняющееся в данный момент приложение сообщает о ней, вызывая исключение, содержащее сведения об ошибке. После возникновения исключения оно обрабатывается приложением или обработчиком исключений по умолчанию.
Содержание
Ошибки и исключения
Попробуйте и поймать блоки
Функции типов исключений
Свойства класса исключений
Рекомендации по производительности
Повторный вызов исключения
Выбор стандартных исключений
Реализация пользовательских исключений
Ошибки и исключения
Ошибки во время выполнения могут возникать по ряду причин. Однако не все ошибки следует обрабатывать как исключения в коде. Ниже приведены некоторые категории ошибок, которые могут возникать во время выполнения, и способы реагирования на них.
Ошибки использования. Ошибка использования представляет собой ошибку в логике программы, которая может привести к исключению. Однако устранить ошибку следует не с помощью обработки исключений, а путем изменения кода ошибки. Например, переопределение Object.Equals(Object) метода в следующем примере предполагает, что
objаргумент всегда должен быть не null.using System; public class Person { private string _name; public string Name { get { return _name; } set { _name = value; } } public override int GetHashCode() { return this.Name.GetHashCode(); } public override bool Equals(object obj) { // This implementation contains an error in program logic: // It assumes that the obj argument is not null. Person p = (Person) obj; return this.Name.Equals(p.Name); } } public class Example { public static void Main() { Person p1 = new Person(); p1.Name = "John"; Person p2 = null; // The following throws a NullReferenceException. Console.WriteLine("p1 = p2: {0}", p1.Equals(p2)); } }// In F#, null is not a valid state for declared types // without 'AllowNullLiteralAttribute' [<AllowNullLiteral>] type Person() = member val Name = "" with get, set override this.GetHashCode() = this.Name.GetHashCode() override this.Equals(obj) = // This implementation contains an error in program logic: // It assumes that the obj argument is not null. let p = obj :?> Person this.Name.Equals p.Name let p1 = Person() p1.Name <- "John" let p2: Person = null // The following throws a NullReferenceException. printfn $"p1 = p2: {p1.Equals p2}"Public Class Person Private _name As String Public Property Name As String Get Return _name End Get Set _name = value End Set End Property Public Overrides Function Equals(obj As Object) As Boolean ' This implementation contains an error in program logic: ' It assumes that the obj argument is not null. Dim p As Person = CType(obj, Person) Return Me.Name.Equals(p.Name) End Function End Class Module Example Public Sub Main() Dim p1 As New Person() p1.Name = "John" Dim p2 As Person = Nothing ' The following throws a NullReferenceException. Console.WriteLine("p1 = p2: {0}", p1.Equals(p2)) End Sub End ModuleИсключение NullReferenceException , возникающее при
objвозникновении ,nullможно устранить, изменив исходный код для явного тестирования на значение NULL перед вызовом Object.Equals переопределения и последующей повторной компиляцией. В следующем примере содержится исправленный исходный код, обрабатывающийnullаргумент .using System; public class Person { private string _name; public string Name { get { return _name; } set { _name = value; } } public override int GetHashCode() { return this.Name.GetHashCode(); } public override bool Equals(object obj) { // This implementation handles a null obj argument. Person p = obj as Person; if (p == null) return false; else return this.Name.Equals(p.Name); } } public class Example { public static void Main() { Person p1 = new Person(); p1.Name = "John"; Person p2 = null; Console.WriteLine("p1 = p2: {0}", p1.Equals(p2)); } } // The example displays the following output: // p1 = p2: False// In F#, null is not a valid state for declared types // without 'AllowNullLiteralAttribute' [<AllowNullLiteral>] type Person() = member val Name = "" with get, set override this.GetHashCode() = this.Name.GetHashCode() override this.Equals(obj) = // This implementation handles a null obj argument. match obj with | :? Person as p -> this.Name.Equals p.Name | _ -> false let p1 = Person() p1.Name <- "John" let p2: Person = null printfn $"p1 = p2: {p1.Equals p2}" // The example displays the following output: // p1 = p2: FalsePublic Class Person Private _name As String Public Property Name As String Get Return _name End Get Set _name = value End Set End Property Public Overrides Function Equals(obj As Object) As Boolean ' This implementation handles a null obj argument. Dim p As Person = TryCast(obj, Person) If p Is Nothing Then Return False Else Return Me.Name.Equals(p.Name) End If End Function End Class Module Example Public Sub Main() Dim p1 As New Person() p1.Name = "John" Dim p2 As Person = Nothing Console.WriteLine("p1 = p2: {0}", p1.Equals(p2)) End Sub End Module ' The example displays the following output: ' p1 = p2: FalseВместо обработки исключений для ошибок использования можно использовать Debug.Assert метод для выявления ошибок использования в отладочных сборках и Trace.Assert метод для выявления ошибок использования как в отладочной, так и в сборке выпуска. Дополнительные сведения см. в разделе Утверждения в управляемом коде.
Ошибки программы. Программная ошибка — это ошибка во время выполнения, которую невозможно избежать, написав код без ошибок.
В некоторых случаях ошибка программы может отражать ожидаемое или обычное состояние ошибки. В этом случае можно избежать использования обработки исключений для устранения ошибки программы и вместо этого повторить операцию. Например, если ожидается, что пользователь вводит дату в определенном формате, можно проанализировать строку даты, вызвав DateTime.TryParseExact метод , который возвращает Boolean значение, указывающее, успешно ли операция синтаксического анализа, а не метод DateTime.ParseExact , который создает FormatException исключение, если не удается преобразовать строку даты в DateTime значение. Аналогичным образом, если пользователь пытается открыть несуществующий файл, можно сначала вызвать File.Exists метод , чтобы проверка, существует ли файл, и, если нет, предложить пользователю создать его.
В других случаях ошибка программы отражает непредвиденное состояние ошибки, которое может быть обработано в коде. Например, даже если вы проверили, что файл существует, он может быть удален перед его открытием или поврежден. В этом случае попытка открыть файл путем создания экземпляра StreamReader объекта или вызова Open метода может вызвать FileNotFoundException исключение. В таких случаях для восстановления после ошибки следует использовать обработку исключений.
Системные сбои. Системный сбой — это ошибка во время выполнения, которая не может быть обработана программным способом. Например, любой OutOfMemoryException метод может вызвать исключение, если среда CLR не может выделить дополнительную память. Обычно системные сбои не обрабатываются с помощью обработки исключений. Вместо этого можно использовать событие, например AppDomain.UnhandledException , и вызвать Environment.FailFast метод для записи в журнал сведений об исключении и уведомления пользователя о сбое перед завершением работы приложения.
Попробуйте и поймать блоки
Среда CLR предоставляет модель обработки исключений, основанную на представлении исключений в виде объектов и на разделении программного кода и кода обработки исключений на try блоки и catch блоки. Может быть один или несколько catch блоков, каждый из которых предназначен для обработки исключений определенного типа, или один блок, предназначенный для перехвата более конкретного исключения, чем другой блок.
Если приложение обрабатывает исключения, возникающие во время выполнения блока кода приложения, код должен быть помещен в инструкцию try и называется блоком try . Код приложения, обрабатывающий исключения, создаваемые блоком try , помещается в инструкцию catch и называется блоком catch . С блоком try связано ноль или несколько catch блоков, и каждый catch блок содержит фильтр типов, определяющий типы исключений, которые он обрабатывает.
При возникновении исключения в try блоке система выполняет поиск связанных catch блоков в том порядке, в который они отображаются в коде приложения, пока не находит catch блок, обрабатывающий исключение. Блок catch обрабатывает исключение типа T , если фильтр типа блока catch указывает T или любой тип, производный T от . Система прекращает поиск после того, как находит первый catch блок, обрабатывающий исключение. По этой причине в коде приложения блок, обрабатывающий тип, catch должен быть указан перед блоком catch , обрабатывающим его базовые типы, как показано в примере, приведенном ниже. Блок catch, который обрабатывает System.Exception , указывается последним.
Если ни один из catch блоков, связанных с текущим try блоком, не обрабатывает исключение и текущий try блок вложен в другие try блоки в текущем вызове, выполняется поиск блоков, catch связанных со следующим включающим try блоком. Если блок исключения не catch найден, система выполняет поиск предыдущих уровней вложения в текущем вызове. catch Если блок для исключения не найден в текущем вызове, исключение передается вверх по стеку вызовов, а в предыдущем кадре стека выполняется поиск блока, обрабатывающего catch исключение. Поиск в стеке вызовов продолжается до тех пор, пока не будет обработано исключение или пока в стеке вызовов не будет больше кадров. Если верхняя часть стека вызовов достигается без поиска catch блока, обрабатывающего исключение, обработчик исключений по умолчанию обрабатывает его, и приложение завершает работу.
F# try.. с выражением
F# не использует catch блоки. Вместо этого возникает исключение, соответствующее шаблону с использованием одного with блока. Так как это выражение, а не оператор, все пути должны возвращать один и тот же тип. Дополнительные сведения см. в разделе Попробовать... с выражением.
Функции типов исключений
Типы исключений поддерживают следующие функции:
Удобочитаемый текст, описывающий ошибку. При возникновении исключения среда выполнения предоставляет текстовое сообщение, информирующее пользователя о характере ошибки и предлагающее действие для устранения проблемы. Это текстовое сообщение хранится в свойстве Message объекта исключения. Во время создания объекта исключения можно передать в конструктор текстовую строку для описания сведений об этом конкретном исключении. Если конструктору не предоставлен аргумент сообщения об ошибке, используется сообщение об ошибке по умолчанию. Дополнительные сведения см. в описании свойства Message.
Состояние стека вызовов при возникновении исключения. Свойство StackTrace содержит трассировку стека, которую можно использовать для определения места возникновения ошибки в коде. Трассировка стека перечисляет все вызываемые методы и номера строк в исходном файле, в котором выполняются вызовы.
Свойства класса исключений
Класс Exception содержит ряд свойств, которые помогают определить расположение кода, тип, файл справки и причину исключения: StackTrace, InnerException, Message, HelpLink, HResult, Source, TargetSiteи Data.
Если между двумя или более исключениями существует причинно-следовая связь, InnerException свойство сохраняет эти сведения. Внешнее исключение создается в ответ на это внутреннее исключение. Код, обрабатывающий внешнее исключение, может использовать сведения из предыдущего внутреннего исключения для более правильной обработки ошибки. Дополнительные сведения об исключении могут храниться в свойстве Data в виде коллекции пар "ключ-значение".
Строка сообщения об ошибке, передаваемая конструктору во время создания объекта исключения, должна быть локализована и может быть предоставлена из файла ресурсов с помощью ResourceManager класса . Дополнительные сведения о локализованных ресурсах см. в разделах Создание вспомогательных сборок и Упаковка и Развертывание ресурсов .
Чтобы предоставить пользователю подробные сведения о том, почему возникло исключение, HelpLink свойство может содержать URL-адрес (или URN) файла справки.
Класс Exception использует COR_E_EXCEPTION HRESULT, имеющий значение 0x80131500.
Список начальных значений свойств для экземпляра класса см. в ExceptionException конструкторах.
Вопросы производительности
Создание или обработка исключения требует значительного объема системных ресурсов и времени выполнения. Создавать исключения только для обработки действительно чрезвычайных условий, а не для обработки прогнозируемых событий или управления потоком. Например, в некоторых случаях, например при разработке библиотеки классов, разумно создавать исключение, если аргумент метода недопустим, так как предполагается, что метод будет вызываться с допустимыми параметрами. Недопустимый аргумент метода, если он не является результатом ошибки использования, означает, что произошло что-то необычное. И наоборот, не следует создавать исключение, если введенные пользователем данные недопустимы, так как можно ожидать, что пользователи могут иногда вводить недопустимые данные. Вместо этого предоставьте механизм повтора, чтобы пользователи могли вводить допустимые входные данные. Также не следует использовать исключения для обработки ошибок использования. Вместо этого используйте утверждения для выявления и исправления ошибок использования.
Кроме того, не создавайте исключение, если кода возврата достаточно; не преобразовывать код возврата в исключение; и не перехватывать исключение, игнорировать его, а затем продолжать обработку.
Повторный вызов исключения
Во многих случаях обработчик исключений просто хочет передать исключение вызывающему объекту. Чаще всего это происходит в следующих ситуациях:
Библиотека классов, которая, в свою очередь, заключает вызовы методов в библиотеке классов платформа .NET Framework или других библиотеках классов.
Приложение или библиотека, в которой возникает неустранимое исключение. Обработчик исключений может регистрировать исключение, а затем повторно создавать исключение.
Рекомендуемый способ повторного создания исключения — просто использовать оператор throw в C#, функцию reraise в F# и оператор Throw в Visual Basic без включения выражения. Это гарантирует сохранение всех сведений о стеке вызовов при распространении исключения на вызывающий объект. Это показано в следующем примере. Строковый метод расширения заключает FindOccurrencesв оболочку один или несколько вызовов без String.IndexOf(String, Int32) предварительной проверки его аргументов.
using System;
using System.Collections.Generic;
using System.Runtime.CompilerServices;
public static class Library
{
public static int[] FindOccurrences(this String s, String f)
{
var indexes = new List<int>();
int currentIndex = 0;
try {
while (currentIndex >= 0 && currentIndex < s.Length) {
currentIndex = s.IndexOf(f, currentIndex);
if (currentIndex >= 0) {
indexes.Add(currentIndex);
currentIndex++;
}
}
}
catch (ArgumentNullException e) {
// Perform some action here, such as logging this exception.
throw;
}
return indexes.ToArray();
}
}
open System
module Library =
let findOccurrences (s: string) (f: string) =
let indexes = ResizeArray()
let mutable currentIndex = 0
try
while currentIndex >= 0 && currentIndex < s.Length do
currentIndex <- s.IndexOf(f, currentIndex)
if currentIndex >= 0 then
indexes.Add currentIndex
currentIndex <- currentIndex + 1
with :? ArgumentNullException ->
// Perform some action here, such as logging this exception.
reraise ()
indexes.ToArray()
Imports System.Collections.Generic
Imports System.Runtime.CompilerServices
Public Module Library
<Extension()>
Public Function FindOccurrences(s As String, f As String) As Integer()
Dim indexes As New List(Of Integer)
Dim currentIndex As Integer = 0
Try
Do While currentIndex >= 0 And currentIndex < s.Length
currentIndex = s.IndexOf(f, currentIndex)
If currentIndex >= 0 Then
indexes.Add(currentIndex)
currentIndex += 1
End If
Loop
Catch e As ArgumentNullException
' Perform some action here, such as logging this exception.
Throw
End Try
Return indexes.ToArray()
End Function
End Module
Затем вызывающий вызывает FindOccurrences дважды. Во втором вызове FindOccurrencesвызывающий объект передает в null качестве строки поиска, что приводит к тому String.IndexOf(String, Int32) , что метод создает ArgumentNullException исключение. Это исключение обрабатывается методом FindOccurrences и передается вызывающей стороне. Так как оператор throw используется без выражения, выходные данные из примера показывают, что стек вызовов сохраняется.
public class Example
{
public static void Main()
{
String s = "It was a cold day when...";
int[] indexes = s.FindOccurrences("a");
ShowOccurrences(s, "a", indexes);
Console.WriteLine();
String toFind = null;
try {
indexes = s.FindOccurrences(toFind);
ShowOccurrences(s, toFind, indexes);
}
catch (ArgumentNullException e) {
Console.WriteLine("An exception ({0}) occurred.",
e.GetType().Name);
Console.WriteLine("Message:\n {0}\n", e.Message);
Console.WriteLine("Stack Trace:\n {0}\n", e.StackTrace);
}
}
private static void ShowOccurrences(String s, String toFind, int[] indexes)
{
Console.Write("'{0}' occurs at the following character positions: ",
toFind);
for (int ctr = 0; ctr < indexes.Length; ctr++)
Console.Write("{0}{1}", indexes[ctr],
ctr == indexes.Length - 1 ? "" : ", ");
Console.WriteLine();
}
}
// The example displays the following output:
// 'a' occurs at the following character positions: 4, 7, 15
//
// An exception (ArgumentNullException) occurred.
// Message:
// Value cannot be null.
// Parameter name: value
//
// Stack Trace:
// at System.String.IndexOf(String value, Int32 startIndex, Int32 count, Stri
// ngComparison comparisonType)
// at Library.FindOccurrences(String s, String f)
// at Example.Main()
open Library
let showOccurrences toFind (indexes: int[]) =
printf $"'{toFind}' occurs at the following character positions: "
for i = 0 to indexes.Length - 1 do
printf $"""{indexes[i]}{if i = indexes.Length - 1 then "" else ", "}"""
printfn ""
let s = "It was a cold day when..."
let indexes = findOccurrences s "a"
showOccurrences "a" indexes
printfn ""
let toFind: string = null
try
let indexes = findOccurrences s toFind
showOccurrences toFind indexes
with :? ArgumentNullException as e ->
printfn $"An exception ({e.GetType().Name}) occurred."
printfn $"Message:\n {e.Message}\n"
printfn $"Stack Trace:\n {e.StackTrace}\n"
// The example displays the following output:
// 'a' occurs at the following character positions: 4, 7, 15
//
// An exception (ArgumentNullException) occurred.
// Message:
// Value cannot be null. (Parameter 'value')
//
// Stack Trace:
// at System.String.IndexOf(String value, Int32 startIndex, Int32 count, Stri
// ngComparison comparisonType)
// at Library.findOccurrences(String s, String f)
// at <StartupCode$fs>.main@()
Module Example
Public Sub Main()
Dim s As String = "It was a cold day when..."
Dim indexes() As Integer = s.FindOccurrences("a")
ShowOccurrences(s, "a", indexes)
Console.WriteLine()
Dim toFind As String = Nothing
Try
indexes = s.FindOccurrences(toFind)
ShowOccurrences(s, toFind, indexes)
Catch e As ArgumentNullException
Console.WriteLine("An exception ({0}) occurred.",
e.GetType().Name)
Console.WriteLine("Message:{0} {1}{0}", vbCrLf, e.Message)
Console.WriteLine("Stack Trace:{0} {1}{0}", vbCrLf, e.StackTrace)
End Try
End Sub
Private Sub ShowOccurrences(s As String, toFind As String, indexes As Integer())
Console.Write("'{0}' occurs at the following character positions: ",
toFind)
For ctr As Integer = 0 To indexes.Length - 1
Console.Write("{0}{1}", indexes(ctr),
If(ctr = indexes.Length - 1, "", ", "))
Next
Console.WriteLine()
End Sub
End Module
' The example displays the following output:
' 'a' occurs at the following character positions: 4, 7, 15
'
' An exception (ArgumentNullException) occurred.
' Message:
' Value cannot be null.
' Parameter name: value
'
' Stack Trace:
' at System.String.IndexOf(String value, Int32 startIndex, Int32 count, Stri
' ngComparison comparisonType)
' at Library.FindOccurrences(String s, String f)
' at Example.Main()
В отличие от этого, если исключение создается повторно с помощью
throw e;
Throw e
raise e
Оператор, полный стек вызовов не сохраняется, и в примере будут создаваться следующие выходные данные:
'a' occurs at the following character positions: 4, 7, 15
An exception (ArgumentNullException) occurred.
Message:
Value cannot be null.
Parameter name: value
Stack Trace:
at Library.FindOccurrences(String s, String f)
at Example.Main()
Немного более громоздким вариантом является создание нового исключения и сохранение сведений о стеке вызовов исходного исключения во внутреннем исключении. Затем вызывающий объект может использовать свойство нового исключения для получения кадра InnerException стека и других сведений об исходном исключении. В этом случае оператор throw имеет следующий тип:
throw new ArgumentNullException("You must supply a search string.",
e);
raise (ArgumentNullException("You must supply a search string.", e) )
Throw New ArgumentNullException("You must supply a search string.",
e)
Пользовательский код, обрабатывающий исключение, должен знать, что InnerException свойство содержит сведения об исходном исключении, как показано в следующем обработчике исключений.
try {
indexes = s.FindOccurrences(toFind);
ShowOccurrences(s, toFind, indexes);
}
catch (ArgumentNullException e) {
Console.WriteLine("An exception ({0}) occurred.",
e.GetType().Name);
Console.WriteLine(" Message:\n{0}", e.Message);
Console.WriteLine(" Stack Trace:\n {0}", e.StackTrace);
Exception ie = e.InnerException;
if (ie != null) {
Console.WriteLine(" The Inner Exception:");
Console.WriteLine(" Exception Name: {0}", ie.GetType().Name);
Console.WriteLine(" Message: {0}\n", ie.Message);
Console.WriteLine(" Stack Trace:\n {0}\n", ie.StackTrace);
}
}
// The example displays the following output:
// 'a' occurs at the following character positions: 4, 7, 15
//
// An exception (ArgumentNullException) occurred.
// Message: You must supply a search string.
//
// Stack Trace:
// at Library.FindOccurrences(String s, String f)
// at Example.Main()
//
// The Inner Exception:
// Exception Name: ArgumentNullException
// Message: Value cannot be null.
// Parameter name: value
//
// Stack Trace:
// at System.String.IndexOf(String value, Int32 startIndex, Int32 count, Stri
// ngComparison comparisonType)
// at Library.FindOccurrences(String s, String f)
try
let indexes = findOccurrences s toFind
showOccurrences toFind indexes
with :? ArgumentNullException as e ->
printfn $"An exception ({e.GetType().Name}) occurred."
printfn $" Message:\n{e.Message}"
printfn $" Stack Trace:\n {e.StackTrace}"
let ie = e.InnerException
if ie <> null then
printfn " The Inner Exception:"
printfn $" Exception Name: {ie.GetType().Name}"
printfn $" Message: {ie.Message}\n"
printfn $" Stack Trace:\n {ie.StackTrace}\n"
// The example displays the following output:
// 'a' occurs at the following character positions: 4, 7, 15
//
// An exception (ArgumentNullException) occurred.
// Message: You must supply a search string.
//
// Stack Trace:
// at Library.FindOccurrences(String s, String f)
// at Example.Main()
//
// The Inner Exception:
// Exception Name: ArgumentNullException
// Message: Value cannot be null.
// Parameter name: value
//
// Stack Trace:
// at System.String.IndexOf(String value, Int32 startIndex, Int32 count, Stri
// ngComparison comparisonType)
// at Library.FindOccurrences(String s, String f)
Try
indexes = s.FindOccurrences(toFind)
ShowOccurrences(s, toFind, indexes)
Catch e As ArgumentNullException
Console.WriteLine("An exception ({0}) occurred.",
e.GetType().Name)
Console.WriteLine(" Message: {1}{0}", vbCrLf, e.Message)
Console.WriteLine(" Stack Trace:{0} {1}{0}", vbCrLf, e.StackTrace)
Dim ie As Exception = e.InnerException
If ie IsNot Nothing Then
Console.WriteLine(" The Inner Exception:")
Console.WriteLine(" Exception Name: {0}", ie.GetType().Name)
Console.WriteLine(" Message: {1}{0}", vbCrLf, ie.Message)
Console.WriteLine(" Stack Trace:{0} {1}{0}", vbCrLf, ie.StackTrace)
End If
End Try
' The example displays the following output:
' 'a' occurs at the following character positions: 4, 7, 15
'
' An exception (ArgumentNullException) occurred.
' Message: You must supply a search string.
'
' Stack Trace:
' at Library.FindOccurrences(String s, String f)
' at Example.Main()
'
' The Inner Exception:
' Exception Name: ArgumentNullException
' Message: Value cannot be null.
' Parameter name: value
'
' Stack Trace:
' at System.String.IndexOf(String value, Int32 startIndex, Int32 count, Stri
' ngComparison comparisonType)
' at Library.FindOccurrences(String s, String f)
Выбор стандартных исключений
При возникновении исключения часто можно использовать существующий тип исключения в платформа .NET Framework вместо реализации настраиваемого исключения. Стандартный тип исключения следует использовать при следующих двух условиях:
Вы создаете исключение, вызванное ошибкой использования (т. е. ошибкой в логике программы, сделанной разработчиком, который вызывает ваш метод). Как правило, создается исключение, например ArgumentException, ArgumentNullException, InvalidOperationExceptionили NotSupportedException. Строка, указываемая конструктору объекта исключения при создании экземпляра объекта исключения, должна описывать ошибку, чтобы разработчик смог исправить ее. Дополнительные сведения см. в описании свойства Message.
Вы обрабатываете ошибку, которая может быть передана вызывающей с помощью существующего исключения платформа .NET Framework. Необходимо создать максимально возможное производное исключение. Например, если для метода требуется, чтобы аргумент был допустимым членом типа перечисления, следует вызвать InvalidEnumArgumentException исключение (наиболее производный ArgumentExceptionкласс), а не .
В следующей таблице перечислены распространенные типы исключений и условия их создания.
| Исключение | Условие |
|---|---|
| ArgumentException | Аргумент, отличный от NULL, передаваемый методу, недопустим. |
| ArgumentNullException | Аргумент, передаваемый в метод , — .null |
| ArgumentOutOfRangeException | Аргумент выходит за пределы диапазона допустимых значений. |
| DirectoryNotFoundException | Недопустимая часть пути к каталогу. |
| DivideByZeroException | Знаменатель в целочисленной операции или Decimal операции деления равен нулю. |
| DriveNotFoundException | Диск недоступен или не существует. |
| FileNotFoundException | Файл не существует. |
| FormatException | Значение не имеет подходящего формата для преобразования из строки методом преобразования, таким как Parse. |
| IndexOutOfRangeException | Индекс находится за пределами массива или коллекции. |
| InvalidOperationException | Вызов метода недопустим в текущем состоянии объекта. |
| KeyNotFoundException | Не удается найти указанный ключ для доступа к члену в коллекции. |
| NotImplementedException | Метод или операция не реализованы. |
| NotSupportedException | Метод или операция не поддерживаются. |
| ObjectDisposedException | Операция выполняется с удаленным объектом. |
| OverflowException | Операция арифметики, приведения или преобразования приводит к переполнению. |
| PathTooLongException | Путь или имя файла превышает максимальную системную длину. |
| PlatformNotSupportedException | Операция не поддерживается на текущей платформе. |
| RankException | Массив с неправильным количеством измерений передается в метод . |
| TimeoutException | Истек интервал времени, выделенный для операции. |
| UriFormatException | Используется недопустимый универсальный код ресурса (URI). |
Реализация пользовательских исключений
В следующих случаях использование существующего исключения платформа .NET Framework для обработки условия ошибки не является достаточным.
Если исключение отражает уникальную ошибку программы, которая не может быть сопоставлена с существующим платформа .NET Framework исключением.
Если исключение требует обработки, отличающейся от обработки, подходящей для существующего исключения платформа .NET Framework, или исключение должно быть неоднозначным от аналогичного исключения. Например, при ArgumentOutOfRangeException возникновении исключения при анализе числового представления строки, которая находится вне диапазона целевого целочисленного типа, не следует использовать то же исключение для ошибки, которая возникает из-за того, что вызывающий объект не предоставляет соответствующие ограниченные значения при вызове метода.
Класс Exception является базовым классом всех исключений в платформа .NET Framework. Многие производные классы зависят от наследуемого Exception поведения членов класса; они не переопределяют члены Exception, а также не определяют уникальные члены.
Чтобы определить собственный класс исключений, выполните следующие действия:
Определите класс, наследующий от Exception. При необходимости определите все уникальные члены, необходимые классу для предоставления дополнительных сведений об исключении. Например, класс включает ParamName свойство , указывающее имя параметра, ArgumentException аргумент которого вызвал исключение, а RegexMatchTimeoutException свойство включает MatchTimeout свойство, указывающее интервал времени ожидания.
При необходимости переопределите все унаследованные члены, функциональные возможности которых требуется изменить или изменить. Обратите внимание, что большинство существующих производных Exception классов не переопределяют поведение наследуемых членов.
Определите, является ли настраиваемый объект исключения сериализуемым. Сериализация позволяет сохранять сведения об исключении и позволяет совместно использовать сведения об исключении сервером и прокси-сервером клиента в контексте удаленного взаимодействия. Чтобы сделать объект исключения сериализуемым, пометьте его атрибутом SerializableAttribute .
Определите конструкторы класса исключений. Как правило, классы исключений имеют один или несколько из следующих конструкторов:
Exception(), который использует значения по умолчанию для инициализации свойств нового объекта исключения.
Exception(String), который инициализирует новый объект исключения с указанным сообщением об ошибке.
Exception(String, Exception), который инициализирует новый объект исключения с указанным сообщением об ошибке и внутренним исключением.
Exception(SerializationInfo, StreamingContext), который является конструктором
protected, который инициализирует новый объект исключения из сериализованных данных. Этот конструктор следует реализовать, если вы решили сделать объект исключения сериализуемым.
В следующем примере показано использование пользовательского класса исключений. Он определяет исключение, которое возникает NotPrimeException , когда клиент пытается получить последовательность простого числа путем указания начального числа, которое не является простым. Исключение определяет новое свойство , NonPrimeкоторое возвращает нестандартное число, вызвавшее исключение. Помимо реализации защищенного конструктора без параметров и конструктора с SerializationInfo параметрами и StreamingContext для сериализации, NotPrimeException класс определяет три дополнительных конструктора для поддержки NonPrime свойства . Каждый конструктор вызывает конструктор базового класса в дополнение к сохранению значения нестандартного числа. Класс также помечается NotPrimeException атрибутом SerializableAttribute .
using System;
using System.Runtime.Serialization;
[Serializable()]
public class NotPrimeException : Exception
{
private int notAPrime;
protected NotPrimeException()
: base()
{ }
public NotPrimeException(int value) :
base(String.Format("{0} is not a prime number.", value))
{
notAPrime = value;
}
public NotPrimeException(int value, string message)
: base(message)
{
notAPrime = value;
}
public NotPrimeException(int value, string message, Exception innerException) :
base(message, innerException)
{
notAPrime = value;
}
protected NotPrimeException(SerializationInfo info,
StreamingContext context)
: base(info, context)
{ }
public int NonPrime
{ get { return notAPrime; } }
}
namespace global
open System
open System.Runtime.Serialization
[<Serializable>]
type NotPrimeException =
inherit Exception
val notAPrime: int
member this.NonPrime =
this.notAPrime
new (value) =
{ inherit Exception($"%i{value} is not a prime number."); notAPrime = value }
new (value, message) =
{ inherit Exception(message); notAPrime = value }
new (value, message, innerException: Exception) =
{ inherit Exception(message, innerException); notAPrime = value }
// F# does not support protected members
new () =
{ inherit Exception(); notAPrime = 0 }
new (info: SerializationInfo, context: StreamingContext) =
{ inherit Exception(info, context); notAPrime = 0 }
Imports System.Runtime.Serialization
<Serializable()> _
Public Class NotPrimeException : Inherits Exception
Private notAPrime As Integer
Protected Sub New()
MyBase.New()
End Sub
Public Sub New(value As Integer)
MyBase.New(String.Format("{0} is not a prime number.", value))
notAPrime = value
End Sub
Public Sub New(value As Integer, message As String)
MyBase.New(message)
notAPrime = value
End Sub
Public Sub New(value As Integer, message As String, innerException As Exception)
MyBase.New(message, innerException)
notAPrime = value
End Sub
Protected Sub New(info As SerializationInfo,
context As StreamingContext)
MyBase.New(info, context)
End Sub
Public ReadOnly Property NonPrime As Integer
Get
Return notAPrime
End Get
End Property
End Class
Класс PrimeNumberGenerator , показанный в следующем примере, использует Sieve Eratosthenes для вычисления последовательности простого числа от 2 до предела, заданного клиентом в вызове конструктора его класса. Метод GetPrimesFrom возвращает все простое число, которое больше или равно указанному нижнему пределу, но вызывает NotPrimeException исключение , если этот нижний предел не является простым числом.
using System;
using System.Collections.Generic;
[Serializable]
public class PrimeNumberGenerator
{
private const int START = 2;
private int maxUpperBound = 10000000;
private int upperBound;
private bool[] primeTable;
private List<int> primes = new List<int>();
public PrimeNumberGenerator(int upperBound)
{
if (upperBound > maxUpperBound)
{
string message = String.Format(
"{0} exceeds the maximum upper bound of {1}.",
upperBound, maxUpperBound);
throw new ArgumentOutOfRangeException(message);
}
this.upperBound = upperBound;
// Create array and mark 0, 1 as not prime (True).
primeTable = new bool[upperBound + 1];
primeTable[0] = true;
primeTable[1] = true;
// Use Sieve of Eratosthenes to determine prime numbers.
for (int ctr = START; ctr <= (int)Math.Ceiling(Math.Sqrt(upperBound));
ctr++)
{
if (primeTable[ctr]) continue;
for (int multiplier = ctr; multiplier <= upperBound / ctr; multiplier++)
if (ctr * multiplier <= upperBound) primeTable[ctr * multiplier] = true;
}
// Populate array with prime number information.
int index = START;
while (index != -1)
{
index = Array.FindIndex(primeTable, index, (flag) => !flag);
if (index >= 1)
{
primes.Add(index);
index++;
}
}
}
public int[] GetAllPrimes()
{
return primes.ToArray();
}
public int[] GetPrimesFrom(int prime)
{
int start = primes.FindIndex((value) => value == prime);
if (start < 0)
throw new NotPrimeException(prime, String.Format("{0} is not a prime number.", prime));
else
return primes.FindAll((value) => value >= prime).ToArray();
}
}
namespace global
open System
[<Serializable>]
type PrimeNumberGenerator(upperBound) =
let start = 2
let maxUpperBound = 10000000
let primes = ResizeArray()
let primeTable =
upperBound + 1
|> Array.zeroCreate<bool>
do
if upperBound > maxUpperBound then
let message = $"{upperBound} exceeds the maximum upper bound of {maxUpperBound}."
raise (ArgumentOutOfRangeException message)
// Create array and mark 0, 1 as not prime (True).
primeTable[0] <- true
primeTable[1] <- true
// Use Sieve of Eratosthenes to determine prime numbers.
for i = start to float upperBound |> sqrt |> ceil |> int do
if not primeTable[i] then
for multiplier = i to upperBound / i do
if i * multiplier <= upperBound then
primeTable[i * multiplier] <- true
// Populate array with prime number information.
let mutable index = start
while index <> -1 do
index <- Array.FindIndex(primeTable, index, fun flag -> not flag)
if index >= 1 then
primes.Add index
index <- index + 1
member _.GetAllPrimes() =
primes.ToArray()
member _.GetPrimesFrom(prime) =
let start =
Seq.findIndex ((=) prime) primes
if start < 0 then
raise (NotPrimeException(prime, $"{prime} is not a prime number.") )
else
Seq.filter ((>=) prime) primes
|> Seq.toArray
Imports System.Collections.Generic
<Serializable()> Public Class PrimeNumberGenerator
Private Const START As Integer = 2
Private maxUpperBound As Integer = 10000000
Private upperBound As Integer
Private primeTable() As Boolean
Private primes As New List(Of Integer)
Public Sub New(upperBound As Integer)
If upperBound > maxUpperBound Then
Dim message As String = String.Format(
"{0} exceeds the maximum upper bound of {1}.",
upperBound, maxUpperBound)
Throw New ArgumentOutOfRangeException(message)
End If
Me.upperBound = upperBound
' Create array and mark 0, 1 as not prime (True).
ReDim primeTable(upperBound)
primeTable(0) = True
primeTable(1) = True
' Use Sieve of Eratosthenes to determine prime numbers.
For ctr As Integer = START To CInt(Math.Ceiling(Math.Sqrt(upperBound)))
If primeTable(ctr) Then Continue For
For multiplier As Integer = ctr To CInt(upperBound \ ctr)
If ctr * multiplier <= upperBound Then primeTable(ctr * multiplier) = True
Next
Next
' Populate array with prime number information.
Dim index As Integer = START
Do While index <> -1
index = Array.FindIndex(primeTable, index, Function(flag)
Return Not flag
End Function)
If index >= 1 Then
primes.Add(index)
index += 1
End If
Loop
End Sub
Public Function GetAllPrimes() As Integer()
Return primes.ToArray()
End Function
Public Function GetPrimesFrom(prime As Integer) As Integer()
Dim start As Integer = primes.FindIndex(Function(value)
Return value = prime
End Function)
If start < 0 Then
Throw New NotPrimeException(prime, String.Format("{0} is not a prime number.", prime))
Else
Return primes.FindAll(Function(value)
Return value >= prime
End Function).ToArray()
End If
End Function
End Class
В следующем примере выполняется GetPrimesFrom два вызова метода с не простыми числами, один из которых пересекает границы домена приложения. В обоих случаях исключение создается и успешно обрабатывается в клиентском коде.
using System;
using System.Reflection;
class Example
{
public static void Main()
{
int limit = 10000000;
PrimeNumberGenerator primes = new PrimeNumberGenerator(limit);
int start = 1000001;
try
{
int[] values = primes.GetPrimesFrom(start);
Console.WriteLine("There are {0} prime numbers from {1} to {2}",
start, limit);
}
catch (NotPrimeException e)
{
Console.WriteLine("{0} is not prime", e.NonPrime);
Console.WriteLine(e);
Console.WriteLine("--------");
}
AppDomain domain = AppDomain.CreateDomain("Domain2");
PrimeNumberGenerator gen = (PrimeNumberGenerator)domain.CreateInstanceAndUnwrap(
typeof(Example).Assembly.FullName,
"PrimeNumberGenerator", true,
BindingFlags.Default, null,
new object[] { 1000000 }, null, null);
try
{
start = 100;
Console.WriteLine(gen.GetPrimesFrom(start));
}
catch (NotPrimeException e)
{
Console.WriteLine("{0} is not prime", e.NonPrime);
Console.WriteLine(e);
Console.WriteLine("--------");
}
}
}
open System
open System.Reflection
let limit = 10000000
let primes = PrimeNumberGenerator limit
let start = 1000001
try
let values = primes.GetPrimesFrom start
printfn $"There are {values.Length} prime numbers from {start} to {limit}"
with :? NotPrimeException as e ->
printfn $"{e.NonPrime} is not prime"
printfn $"{e}"
printfn "--------"
let domain = AppDomain.CreateDomain "Domain2"
let gen =
domain.CreateInstanceAndUnwrap(
typeof<PrimeNumberGenerator>.Assembly.FullName,
"PrimeNumberGenerator", true,
BindingFlags.Default, null,
[| box 1000000 |], null, null)
:?> PrimeNumberGenerator
try
let start = 100
printfn $"{gen.GetPrimesFrom start}"
with :? NotPrimeException as e ->
printfn $"{e.NonPrime} is not prime"
printfn $"{e}"
printfn "--------"
Imports System.Reflection
Module Example
Sub Main()
Dim limit As Integer = 10000000
Dim primes As New PrimeNumberGenerator(limit)
Dim start As Integer = 1000001
Try
Dim values() As Integer = primes.GetPrimesFrom(start)
Console.WriteLine("There are {0} prime numbers from {1} to {2}",
start, limit)
Catch e As NotPrimeException
Console.WriteLine("{0} is not prime", e.NonPrime)
Console.WriteLine(e)
Console.WriteLine("--------")
End Try
Dim domain As AppDomain = AppDomain.CreateDomain("Domain2")
Dim gen As PrimeNumberGenerator = domain.CreateInstanceAndUnwrap(
GetType(Example).Assembly.FullName,
"PrimeNumberGenerator", True,
BindingFlags.Default, Nothing,
{1000000}, Nothing, Nothing)
Try
start = 100
Console.WriteLine(gen.GetPrimesFrom(start))
Catch e As NotPrimeException
Console.WriteLine("{0} is not prime", e.NonPrime)
Console.WriteLine(e)
Console.WriteLine("--------")
End Try
End Sub
End Module
' The example displays the following output:
' 1000001 is not prime
' NotPrimeException: 1000001 is not a prime number.
' at PrimeNumberGenerator.GetPrimesFrom(Int32 prime)
' at Example.Main()
' --------
' 100 is not prime
' NotPrimeException: 100 is not a prime number.
' at PrimeNumberGenerator.GetPrimesFrom(Int32 prime)
' at Example.Main()
' --------
среда выполнения Windows и платформа .NET Framework 4.5.1
В приложениях Магазина .NET для Windows 8.x для Windows 8 некоторые сведения об исключении обычно теряются, когда исключение распространяется через кадры стека, не относящиеся к платформа .NET Framework. Начиная с платформа .NET Framework 4.5.1 и Windows 8.1 среда CLR продолжает использовать исходный Exception объект, который был создан, если это исключение не было изменено в кадре стека, отличном от платформа .NET Framework.
Конструкторы
| Exception() |
Инициализирует новый экземпляр класса Exception. |
| Exception(SerializationInfo, StreamingContext) |
Является устаревшей.
Инициализирует новый экземпляр класса Exception с сериализованными данными. |
| Exception(String) |
Инициализирует новый экземпляр класса Exception с указанным сообщением об ошибке. |
| Exception(String, Exception) |
Инициализирует новый экземпляр класса Exception указанным сообщением об ошибке и ссылкой на внутреннее исключение, вызвавшее данное исключение. |
Свойства
| Data |
Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении. |
| HelpLink |
Получает или задает ссылку на файл справки, связанный с этим исключением. |
| HResult |
Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению. |
| InnerException |
Возвращает экземпляр класса Exception, который вызвал текущее исключение. |
| Message |
Возвращает сообщение, описывающее текущее исключение. |
| Source |
Возвращает или задает имя приложения или объекта, вызывавшего ошибку. |
| StackTrace |
Получает строковое представление непосредственных кадров в стеке вызова. |
| TargetSite |
Возвращает метод, создавший текущее исключение. |
Методы
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetBaseException() |
При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Является устаревшей.
При переопределении в производном классе задает объект SerializationInfo со сведениями об исключении. |
| GetType() |
Возвращает тип среды выполнения текущего экземпляра. |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| ToString() |
Создает и возвращает строковое представление текущего исключения. |
События
| SerializeObjectState |
Является устаревшей.
Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении. |