Exception Exception Exception Exception Class

定義

アプリケーションの実行中に発生したエラーを表します。 Represents errors that occur during application execution.

public ref class Exception : System::Runtime::InteropServices::_Exception, System::Runtime::Serialization::ISerializable
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDual)]
[Serializable]
public class Exception : System.Runtime.InteropServices._Exception, System.Runtime.Serialization.ISerializable
type Exception = class
    interface ISerializable
    interface _Exception
Public Class Exception
Implements _Exception, ISerializable
継承
ExceptionExceptionExceptionException
派生
属性
実装

次の例で、catch処理するために定義されているブロックArithmeticExceptionエラー。The following example demonstrates a catch block that is defined to handle ArithmeticException errors. これは、catchキャッチでブロックもDivideByZeroExceptionエラー、ためDivideByZeroExceptionから派生ArithmeticExceptionはありませんcatchを明示的に定義されているブロックDivideByZeroExceptionエラー。This catch block also catches DivideByZeroException errors, because DivideByZeroException derives from ArithmeticException and there is no catch block explicitly defined for DivideByZeroException errors.

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: {0}", e.ToString());
         }
         catch (Exception e) 
         {
            Console.WriteLine("Generic Exception Handler: {0}", e.ToString());
         }
   }	
}
/*
This code example produces the following results:

ArithmeticException Handler: System.DivideByZeroException: Attempted to divide by zero.
   at ExceptionTestClass.Main()

*/
Imports System

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 'Main
End Class 'ExceptionTestClass
'
'This code example produces the following results:
'
'ArithmeticException Handler: System.OverflowException: Arithmetic operation resulted in an overflow.
'   at ExceptionTestClass.Main()
'

注釈

このクラスは、すべての例外の基本クラスです。This class is the base class for all exceptions. エラーが発生したときに、システムまたは現在実行中のアプリケーションのいずれかがによって報告、エラーに関する情報を含む例外をスローします。When an error occurs, either the system or the currently executing application reports it by throwing an exception that contains information about the error. 例外がスローされた後、アプリケーションまたは既定の例外ハンドラーによって処理されます。After an exception is thrown, it is handled by the application or by the default exception handler.

このセクションの内容:In this section:

エラーと例外 Errors and exceptions
Try/catch ブロック Try/catch blocks
例外の種類の機能 Exception type features
例外クラスのプロパティ Exception class properties
パフォーマンスに関する考慮事項 Performance considerations
例外の再スロー Re-throwing an exception
標準の例外を選択します。 Choosing standard exceptions
カスタム例外を実装します。Implementing custom exceptions

エラーと例外Errors and exceptions

実行時エラーは、さまざまな理由で発生します。Run-time errors can occur for a variety of reasons. ただし、すべてのエラーは、コードの例外として処理する必要があります。However, not all errors should be handled as exceptions in your code. ここでは、実行時とそれらに応答する適切な方法で発生する可能性があるエラーのいくつかのカテゴリです。Here are some categories of errors that can occur at run time and the appropriate ways to respond to them.

  • 使用状況のエラー。Usage errors. 使用法のエラーは、例外が発生するプログラム ロジックでエラーを表します。A usage error represents an error in program logic that can result in an exception. ただし、エラーは、例外処理ではなく、問題のあるコードを変更することでアドレス指定する必要があります。However, the error should be addressed not through exception handling but by modifying the faulty code. オーバーライドなど、Object.Equals(Object)メソッドは、次の例を前提としているobj引数は null 以外に常にあります。For example, the override of the Object.Equals(Object) method in the following example assumes that the obj argument must always be non-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));   
       }
    }
    
    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の例外をときobjnull明示的に呼び出す前に null をテストするソース コードを修正して取り除くことができます、 Object.Equals override キーワードと再コンパイルします。The NullReferenceException exception that results when obj is null can be eliminated by modifying the source code to explicitly test for null before calling the Object.Equals override and then re-compiling. 次の例には処理する修正されたソース コードが含まれています、null引数。The following example contains the corrected source code that handles a null argument.

    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
    
    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 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デバッグとリリースの両方で使用エラーを識別するためにメソッドが構築されます。Instead of using exception handling for usage errors, you can use the Debug.Assert method to identify usage errors in debug builds, and the Trace.Assert method to identify usage errors in both debug and release builds. 詳細については、次を参照してください。マネージ コードでアサーションします。For more information, see Assertions in Managed Code.

  • プログラムのエラー。Program errors. プログラム エラーは、必ずしもバグのないコードを記述することで回避することはできませんが、ランタイム エラーです。A program error is a run-time error that cannot necessarily be avoided by writing bug-free code.

    場合によっては、プログラム エラーは、想定または日常的なエラー状態を反映可能性があります。In some cases, a program error may reflect an expected or routine error condition. ここでは、プログラム エラーを処理し、代わりに、操作を再試行する例外処理の使用を回避する可能性があります。In this case, you may want to avoid using exception handling to deal with the program error and instead retry the operation. たとえば場合は、ユーザーが特定の形式で日付を入力必要ですが、解析できます日付文字列を呼び出して、DateTime.TryParseExactを返すメソッドをBooleanを使用する代わりに、解析操作が成功したかどうかを示す値DateTime.ParseExactメソッドがスローされます、FormatException日付文字列に変換できない場合は例外をDateTime値。For example, if the user is expected to input a date in a particular format, you can parse the date string by calling the DateTime.TryParseExact method, which returns a Boolean value that indicates whether the parse operation succeeded, instead of using the DateTime.ParseExact method, which throws a FormatException exception if the date string cannot be converted to a DateTime value. 同様に、ユーザーは、存在しないファイルを開くしようとすると、最初に呼び出せる、File.Existsファイルが存在し、その場合は、作成するかどうか、ユーザーを要求するかどうかを確認する方法。Similarly, if a user tries to open a file that does not exist, you can first call the File.Exists method to check whether the file exists and, if it does not, prompt the user whether he or she wants to create it.

    それ以外の場合は、プログラム エラーは、コードで処理できる、予期しないエラー状態を反映します。In other cases, a program error reflects an unexpected error condition that can be handled in your code. たとえば、場合でも、ファイルが存在することを確認したら、それが削除できます前に、それを開くか、または、壊れている可能性があります。For example, even if you've checked to ensure that a file exists, it may be deleted before you can open it, or it may be corrupted. その場合は、インスタンス化してファイルを開こうとした、StreamReaderオブジェクトまたは呼び出し元、Openメソッドがスローする可能性が、FileNotFoundException例外。In that case, trying to open the file by instantiating a StreamReader object or calling the Open method may throw a FileNotFoundException exception. このような場合は、例外、エラーから回復する処理を使用する必要があります。In these cases, you should use exception handling to recover from the error.

  • システム障害。System failures. システム障害は、プログラムでは意味のある方法で処理できない実行時エラーです。A system failure is a run-time error that cannot be handled programmatically in a meaningful way. たとえば、任意のメソッドをスローできます、OutOfMemoryException例外の場合は、共通言語ランタイムが追加のメモリを割り当てることができません。For example, any method can throw an OutOfMemoryException exception if the common language runtime is unable to allocate additional memory. 通常、システム障害は例外処理を使用して、処理されません。Ordinarily, system failures are not handled by using exception handling. 代わりに、できる場合がありますなど、イベントを使用するAppDomain.UnhandledExceptionを呼び出すと、Environment.FailFast例外情報を記録し、アプリケーションが終了する前に、エラーをユーザーに通知するメソッド。Instead, you may be able to use an event such as AppDomain.UnhandledException and call the Environment.FailFast method to log exception information and notify the user of the failure before the application terminates.

Try/catch ブロックTry/catch blocks

共通言語ランタイムは、例外として、オブジェクトの表現とプログラム コードと例外処理にコードの分離に基づく例外処理モデルを提供します。tryブロックとcatchブロックします。The common language runtime provides an exception handling model that is based on the representation of exceptions as objects, and the separation of program code and exception handling code into try blocks and catch blocks. 1 つまたは複数があることができますcatchブロックする場合に、それぞれ特定の種類の例外、または別のブロックよりも具体的な例外をキャッチする 1 つのブロックを処理するために設計されています。There can be one or more catch blocks, each designed to handle a particular type of exception, or one block designed to catch a more specific exception than another block.

コードがある必要があります内に配置するアプリケーションでは、アプリケーション コードのブロックの実行中に発生する例外を処理する場合、tryステートメントと呼びます、tryブロックします。If an application handles exceptions that occur during the execution of a block of application code, the code must be placed within a try statement and is called a try block. によってスローされた例外を処理するアプリケーション コード、tryブロックが内に配置される、catchステートメントと呼びます、catchブロックします。Application code that handles exceptions thrown by a try block is placed within a catch statement and is called a catch block. 0 個以上catchブロックに関連付けられ、tryブロック、および各catchブロックに処理する例外の種類を決定する種類のフィルターが含まれています。Zero or more catch blocks are associated with a try block, and each catch block includes a type filter that determines the types of exceptions it handles.

例外が発生したときに、tryブロック、システムに関連付けられている検索catchことによって検出されるまでに、アプリケーション コードに表示される順序でブロックをcatch例外を処理するブロック。When an exception occurs in a try block, the system searches the associated catch blocks in the order they appear in application code, until it locates a catch block that handles the exception. Acatchブロック型の例外を処理Tcatch ブロックの種類のフィルターが指定されている場合T任意の型またはTから派生します。A catch block handles an exception of type T if the type filter of the catch block specifies T or any type that T derives from. システムが 1 つ目のインスタンスを検出した後に検索を停止したcatch例外を処理するブロック。The system stops searching after it finds the first catch block that handles the exception. このため、アプリケーション コードで、catch前に、型を処理するブロックを指定する必要があります、catchこのセクションの次の例に示すように、基本型を処理するブロック。For this reason, in application code, a catch block that handles a type must be specified before a catch block that handles its base types, as demonstrated in the example that follows this section. 処理する catch ブロックSystem.Exception最後に指定します。A catch block that handles System.Exception is specified last.

None の場合、catchに現在関連付けられているブロックtryブロック処理、例外と現在try内でその他のブロックが入れ子になったtry、現在の呼び出しでブロック、catchブロックに次の関連付けそれを囲むtryブロックが検索されます。If none of the catch blocks associated with the current try block handle the exception, and the current try block is nested within other try blocks in the current call, the catch blocks associated with the next enclosing try block are searched. ない場合はcatch例外のブロックが見つかると、システムは、現在の呼び出しの前の入れ子レベルを検索します。If no catch block for the exception is found, the system searches previous nesting levels in the current call. ない場合はcatchブロック、例外が、現在の呼び出しで見つかった、コール スタックに渡された例外および以前のスタック フレームが検索、catch例外を処理するブロック。If no catch block for the exception is found in the current call, the exception is passed up the call stack, and the previous stack frame is searched for a catch block that handles the exception. 呼び出し履歴にフレームがなくなるまで、または、例外が処理されるまで、呼び出し履歴の検索が続行されます。The search of the call stack continues until the exception is handled or until no more frames exist on the call stack. 検索せず、呼び出しスタックの一番上に達した場合、catch既定の例外ハンドラー、例外処理ブロックを処理し、アプリケーションが終了します。If the top of the call stack is reached without finding a catch block that handles the exception, the default exception handler handles it and the application terminates.

例外の種類の機能Exception type features

例外の種類は、次の機能をサポートします。Exception types support the following features:

  • エラーを説明する人間が判読できるテキスト。Human-readable text that describes the error. 例外が発生したときに、ランタイムは、問題を解決するのには、エラーの性質をユーザーに通知し、アクションを提案する使用可能なテキスト メッセージにします。When an exception occurs, the runtime makes a text message available to inform the user of the nature of the error and to suggest action to resolve the problem. このテキスト メッセージが保持されている、Message例外オブジェクトのプロパティ。This text message is held in the Message property of the exception object. 例外オブジェクトを作成する際は、コンス トラクターに、その特定の例外の詳細を説明テキスト文字列を渡すことができます。During the creation of the exception object, you can pass a text string to the constructor to describe the details of that particular exception. コンス トラクターにエラー メッセージの引数が指定されていない場合は、既定のエラー メッセージが使用されます。If no error message argument is supplied to the constructor, the default error message is used. 詳細については、Message プロパティを参照してください。For more information, see the Message property.

  • 例外がスローされたときに、呼び出し履歴の状態。The state of the call stack when the exception was thrown. StackTraceプロパティは、コードでエラーが発生するかを判断するのに使用できるスタック トレースを保持します。The StackTrace property carries a stack trace that can be used to determine where the error occurs in the code. スタック トレースは、呼び出されたすべてのメソッドと、呼び出しが行われる場所のソース ファイル内の行番号を示します。The stack trace lists all the called methods and the line numbers in the source file where the calls are made.

例外クラスのプロパティException class properties

Exceptionクラスには、さまざまなコードの場所、種類、ヘルプ ファイル、および例外の原因の特定に役立つプロパティが含まれています: StackTraceInnerExceptionMessageHelpLinkHResultSourceTargetSite、およびDataします。The Exception class includes a number of properties that help identify the code location, the type, the help file, and the reason for the exception: StackTrace, InnerException, Message, HelpLink, HResult, Source, TargetSite, and Data.

2 つ以上の例外と因果関係が存在する場合に、InnerExceptionプロパティは、この情報を保持します。When a causal relationship exists between two or more exceptions, the InnerException property maintains this information. この内部例外への応答では、外側の例外がスローされます。The outer exception is thrown in response to this inner exception. 外側の例外を処理するコードは、前の内部例外からの情報を使用して、エラーをより適切に処理できます。The code that handles the outer exception can use the information from the earlier inner exception to handle the error more appropriately. 内のキー/値ペアのコレクションとして、例外に関する補足情報を格納できる、Dataプロパティ。Supplementary information about the exception can be stored as a collection of key/value pairs in the Data property.

例外オブジェクトの作成時に、コンス トラクターに渡されるエラー メッセージ文字列はローカライズする必要があるし、を使用してリソース ファイルから指定することができます、ResourceManagerクラス。The error message string that is passed to the constructor during the creation of the exception object should be localized and can be supplied from a resource file by using the ResourceManager class. ローカライズされたリソースの詳細については、次を参照してください。、サテライト アセンブリの作成Packaging and Deploying Resourcesトピック。For more information about localized resources, see the Creating Satellite Assemblies and Packaging and Deploying Resources topics.

例外が発生した理由に関する詳細情報をユーザーに提供する、HelpLinkプロパティがヘルプ ファイルへの URL (または URN) を保持できます。To provide the user with extensive information about why the exception occurred, the HelpLink property can hold a URL (or URN) to a help file.

Exceptionクラスは、値が 0x80131500 HRESULT COR_E_EXCEPTION を使用します。The Exception class uses the HRESULT COR_E_EXCEPTION, which has the value 0x80131500.

インスタンスの初期プロパティ値の一覧については、Exceptionクラスを参照してください、Exceptionコンス トラクター。For a list of initial property values for an instance of the Exception class, see the Exception constructors.

パフォーマンスに関する考慮事項Performance considerations

スローすることや、例外の処理は、大量のシステム リソースと実行時間を消費します。Throwing or handling an exception consumes a significant amount of system resources and execution time. 予測可能なイベントを処理したり、フロー制御が、真に異常な状態の処理にのみ例外をスローします。Throw exceptions only to handle truly extraordinary conditions, not to handle predictable events or flow control. たとえば、場合によっては、クラス ライブラリを開発しているときなど、メソッドの引数は、有効なパラメーターで呼び出されるメソッドを想定しているため有効でない場合は、例外をスローする妥当なは。For example, in some cases, such as when you're developing a class library, it's reasonable to throw an exception if a method argument is invalid, because you expect your method to be called with valid parameters. 無効なメソッド引数では、使用状況、エラーの結果でない場合に、何か異常が発生したことを意味します。An invalid method argument, if it is not the result of a usage error, means that something extraordinary has occurred. 逆は例外はスローされません、場合によっては無効なデータを入力するユーザーを想定できるため、ユーザー入力が有効でない場合。Conversely, do not throw an exception if user input is invalid, because you can expect users to occasionally enter invalid data. 代わりに、ユーザーは、有効な入力を入力できるように再試行メカニズムを提供します。Instead, provide a retry mechanism so users can enter valid input. また、使用状況のエラーを処理する例外を使用する必要があります。Nor should you use exceptions to handle usage errors. 代わりに、アサーションを特定し、使用状況のエラーを修正します。Instead, use assertions to identify and correct usage errors.

リターン コードで十分です。 ときに例外をスローしないでくださいさらに、リターン コードを例外に変換できません。および例外定期的に catch は、無視するか、および処理を続行します。In addition, do not throw an exception when a return code is sufficient; do not convert a return code to an exception; and do not routinely catch an exception, ignore it, and then continue processing.

例外の再スローRe-throwing an exception

多くの場合、例外ハンドラーは、呼び出し元に例外を渡すだけですが。In many cases, an exception handler simply wants to pass the exception on to the caller. このほとんどは、多くの場合に行われます。This most often occurs in:

  • さらに、.NET Framework クラス ライブラリやその他のクラス ライブラリでメソッドの呼び出しをラップするクラス ライブラリです。A class library that in turn wraps calls to methods in the .NET Framework class library or other class libraries.

  • アプリケーションまたは致命的な例外が発生するライブラリ。An application or library that encounters a fatal exception. 例外ハンドラーでは、例外をログにでき、例外を再スローすることができます。The exception handler can log the exception and then re-throw the exception.

例外を再スローするお勧めの方法は、単に使用する、スロー (C#) ステートメント、スロー式を含めず、Visual Basic でのステートメント。The recommended way to re-throw an exception is to simply use the throw statement in C# and the Throw statement in Visual Basic without including an expression. これにより、呼び出し元に例外が伝達されるすべての呼び出し履歴情報を保持します。This ensures that all call stack information is preserved when the exception is propagated to the caller. 次に例を示します。The following example illustrates this. 文字列の拡張メソッドでFindOccurrences、1 つまたは複数の呼び出しをラップしますString.IndexOf(String, Int32)その引数の事前検証なし。A string extension method, FindOccurrences, wraps one or more calls to String.IndexOf(String, Int32) without validating its arguments beforehand.

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();
   }
}
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

呼び出し元を呼び出してFindOccurrences2 回クリックします。A caller then calls FindOccurrences twice. 2 番目の呼び出しでFindOccurrences、呼び出し元のパスをnullケースを検索文字列として、String.IndexOf(String, Int32)をスローするメソッド、ArgumentNullException例外。In the second call to FindOccurrences, the caller passes a null as the search string, which cases the String.IndexOf(String, Int32) method to throw an ArgumentNullException exception. によってこの例外を処理、FindOccurrencesメソッドを呼び出し元に渡されたバックします。This exception is handled by the FindOccurrences method and passed back to the caller. 式のない throw ステートメントを使用しているため、例からの出力は、呼び出し履歴が保持されることを示します。Because the throw statement is used with no expression, the output from the example shows that the call stack is preserved.

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()
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()

一方を使用して、例外が再スローされた場合、In contrast, if the exception is re-thrown by using the

throw e  
Throw e  

ステートメントでは、完全な呼び出し履歴は保持されませんし、例は、次の出力を生成します。statement, the full call stack is not preserved, and the example would generate 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 Library.FindOccurrences(String s, String f)  
   at Example.Main()  

少し煩雑な代替手段は、新しい例外をスローして、内部例外の元の例外のコール スタック情報を保持するためには。A slightly more cumbersome alternative is to throw a new exception, and to preserve the original exception's call stack information in an inner exception. 呼び出し元は、新しい例外を使用できますInnerExceptionプロパティがスタック フレームと、元の例外に関する他の情報を取得します。The caller can then use the new exception's InnerException property to retrieve stack frame and other information about the original exception. この場合は、throw ステートメントは次のとおりです。In this case, the throw statement is:

throw new ArgumentNullException("You must supply a search string.",
                                e);
Throw New ArgumentNullException("You must supply a search string.",
                                e)

例外を処理するユーザー コードが認識することが、InnerExceptionプロパティは、次の例外ハンドラーに示すように、元の例外に関する情報を格納します。The user code that handles the exception has to know that the InnerException property contains information about the original exception, as the following exception handler illustrates.

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
   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)

標準の例外を選択します。Choosing standard exceptions

例外をスローするときに、カスタム例外を実装する代わりに .NET Framework の多くの場合、既存の例外の種類を使用できます。When you have to throw an exception, you can often use an existing exception type in the .NET Framework instead of implementing a custom exception. これら 2 つの条件下で、標準の例外の種類を使用する必要があります。You should use a standard exception type under these two conditions:

  • 使用法のエラーによって引き起こされる例外をスローしている (つまり、メソッドを呼び出すことが開発者によって行われたプログラム ロジックのエラーによって)。You are throwing an exception that is caused by a usage error (that is, by an error in program logic made by the developer who is calling your method). 通常は例外をスローするようArgumentExceptionArgumentNullExceptionInvalidOperationException、またはNotSupportedExceptionします。Typically, you would throw an exception such as ArgumentException, ArgumentNullException, InvalidOperationException, or NotSupportedException. 開発者によって修正できるように、エラーを記述する必要があります、例外オブジェクトをインスタンス化するときに、例外オブジェクトのコンス トラクターを指定する文字列。The string you supply to the exception object's constructor when instantiating the exception object should describe the error so that the developer can fix it. 詳細については、Message プロパティを参照してください。For more information, see the Message property.

  • 既存の .NET Framework の例外で呼び出し元に伝えることがエラーが処理されます。You are handling an error that can be communicated to the caller with an existing .NET Framework exception. 考えられる最も派生例外をスローする必要があります。You should throw the most derived exception possible. たとえば、メソッドが有効な列挙型のメンバーである引数を必要とする必要がありますをスローする、 InvalidEnumArgumentException (最も派生クラス) ではなく、ArgumentExceptionします。For example, if a method requires an argument to be a valid member of an enumeration type, you should throw an InvalidEnumArgumentException (the most derived class) rather than an ArgumentException.

次の表は、一般的な例外タイプとをそれらをスローは条件を示します。The following table lists common exception types and the conditions under which you would throw them.

例外Exception 条件Condition
ArgumentException メソッドに渡される null 以外の引数が無効です。A non-null argument that is passed to a method is invalid.
ArgumentNullException メソッドに渡される引数がnullします。An argument that is passed to a method is null.
ArgumentOutOfRangeException 引数は、有効な値の範囲外です。An argument is outside the range of valid values.
DirectoryNotFoundException ディレクトリ パスの一部が無効です。Part of a directory path is not valid.
DivideByZeroException 整数で、分母またはDecimal除算演算が 0 です。The denominator in an integer or Decimal division operation is zero.
DriveNotFoundException ドライブをご利用いただけませんまたは存在しません。A drive is unavailable or does not exist.
FileNotFoundException ファイルが存在しません。A file does not exist.
FormatException などの変換メソッドによって、文字列から変換する適切な形式で値がないParseします。A value is not in an appropriate format to be converted from a string by a conversion method such as Parse.
IndexOutOfRangeException インデックスが配列またはコレクションの範囲外です。An index is outside the bounds of an array or collection.
InvalidOperationException メソッドの呼び出しがオブジェクトの現在の状態では無効です。A method call is invalid in an object's current state.
KeyNotFoundException コレクション内のメンバーにアクセスするための指定したキーが見つかりません。The specified key for accessing a member in a collection cannot be found.
NotImplementedException メソッドまたは操作が実装されていません。A method or operation is not implemented.
NotSupportedException メソッドまたは操作がサポートされていません。A method or operation is not supported.
ObjectDisposedException 操作が破棄されているオブジェクト。An operation is performed on an object that has been disposed.
OverflowException 算術演算、キャストまたは変換操作の結果はオーバーフローが発生します。An arithmetic, casting, or conversion operation results in an overflow.
PathTooLongException パスまたはファイル名は、システム定義の最大長を超えています。A path or file name exceeds the maximum system-defined length.
PlatformNotSupportedException 現在のプラットフォームでは、操作がサポートされていません。The operation is not supported on the current platform.
RankException 問題の次元数を含む配列がメソッドに渡されます。An array with the wrong number of dimensions is passed to a method.
TimeoutException 操作に割り当てられた時間間隔が終了しました。The time interval allotted to an operation has expired.
UriFormatException 無効な Uniform Resource Identifier (URI) が使用されます。An invalid Uniform Resource Identifier (URI) is used.

カスタム例外を実装します。Implementing custom exceptions

次の場合、既存の .NET Framework の例外を使用して、エラー状態を処理するための適切ではありません。In the following cases, using an existing .NET Framework exception to handle an error condition is not adequate:

  • ときに、例外には、既存の .NET Framework の例外にマップできない固有のプログラム エラーが反映されます。When the exception reflects a unique program error that cannot be mapped to an existing .NET Framework exception.

  • 例外の処理とは異なる既存の .NET Framework の例外または例外を適切な処理が必要な場合は、同様の例外から区別する必要があります。When the exception requires handling that is different from the handling that is appropriate for an existing .NET Framework exception, or the exception must be disambiguated from a similar exception. スローする場合など、ArgumentOutOfRangeException例外のターゲットの整数型の範囲外である文字列の数値表現の解析中に、しない、同じ例外を指定していない呼び出し元に起因するエラーに使用する、メソッドを呼び出すと、適切なのことに制約されている値。For example, if you throw an ArgumentOutOfRangeException exception when parsing the numeric representation of a string that is out of range of the target integral type, you would not want to use the same exception for an error that results from the caller not supplying the appropriate constrained values when calling the method.

Exceptionクラスは、.NET Framework のすべての例外の基本クラスです。The Exception class is the base class of all exceptions in the .NET Framework. 多くの派生クラスのメンバーの継承の動作に依存、 Exception ; クラスのメンバーをオーバーライドしないでException、またも任意の一意のメンバーを定義しないでください。Many derived classes rely on the inherited behavior of the members of the Exception class; they do not override the members of Exception, nor do they define any unique members.

独自の例外クラスを定義するには。To define your own exception class:

  1. 継承するクラスを定義Exceptionします。Define a class that inherits from Exception. 必要に応じて、例外に関する追加情報を提供するクラスに必要な任意の一意のメンバーを定義します。If necessary, define any unique members needed by your class to provide additional information about the exception. など、ArgumentExceptionクラスが含まれています、ParamNameの引数の例外の原因となったパラメーターの名前を指定するプロパティとRegexMatchTimeoutExceptionプロパティが含まれています、MatchTimeoutタイムアウト間隔を示すプロパティです。For example, the ArgumentException class includes a ParamName property that specifies the name of the parameter whose argument caused the exception, and the RegexMatchTimeoutException property includes a MatchTimeout property that indicates the time-out interval.

  2. 必要に応じて、変更または変更する機能を持つ継承されたメンバーをオーバーライドします。If necessary, override any inherited members whose functionality you want to change or modify. 既存のほとんどを派生クラスのException継承されたメンバーの動作をオーバーライドできません。Note that most existing derived classes of Exception do not override the behavior of inherited members.

  3. カスタム例外オブジェクトがシリアル化できるかどうかを決定します。Determine whether your custom exception object is serializable. シリアル化では、例外に関する情報を保存することができ、例外情報をリモート処理コンテキスト内のサーバーとクライアント プロキシで共有を許可します。Serialization enables you to save information about the exception and permits exception information to be shared by a server and a client proxy in a remoting context. 例外オブジェクトをシリアル化可能にするには、マークで、SerializableAttribute属性。To make the exception object serializable, mark it with the SerializableAttribute attribute.

  4. 例外クラスのコンス トラクターを定義します。Define the constructors of your exception class. 通常、例外クラスは、次のコンス トラクターの 1 つ以上あります。Typically, exception classes have one or more of the following constructors:

    • Exception()、既定値を使用する新しい例外オブジェクトのプロパティを初期化します。Exception(), which uses default values to initialize the properties of a new exception object.

    • Exception(String)を指定したエラー メッセージが新しい例外オブジェクトを初期化します。Exception(String), which initializes a new exception object with a specified error message.

    • Exception(String, Exception)を指定したエラー メッセージと内部例外を新しい例外オブジェクトを初期化します。Exception(String, Exception), which initializes a new exception object with a specified error message and inner exception.

    • Exception(SerializationInfo, StreamingContext)、これは、protectedからの新しい例外オブジェクトを初期化するコンス トラクターにシリアル化されたデータ。Exception(SerializationInfo, StreamingContext), which is a protected constructor that initializes a new exception object from serialized data. 例外オブジェクトをシリアル化できるようにすることを選択した場合は、このコンス トラクターを実装する必要があります。You should implement this constructor if you've chosen to make your exception object serializable.

次の例では、カスタム例外クラスの使用を示します。The following example illustrates the use of a custom exception class. 定義、NotPrimeExceptionクライアントが素数でない開始番号を指定することによって、素数のシーケンスを取得する場合にスローされる例外。It defines a NotPrimeException exception that is thrown when a client tries to retrieve a sequence of prime numbers by specifying a starting number that is not prime. 例外は、新しいプロパティを定義します。 NonPrime、、以外の素数、例外の原因となったを返します。The exception defines a new property, NonPrime, that returns the non-prime number that caused the exception. 保護されているパラメーターなしのコンス トラクターを持つコンス トラクターを実装するだけでなくSerializationInfoStreamingContextパラメーターのシリアル化、NotPrimeExceptionクラス定義をサポートする 3 つの追加コンス トラクター、NonPrimeプロパティ。Besides implementing a protected parameterless constructor and a constructor with SerializationInfo and StreamingContext parameters for serialization, the NotPrimeException class defines three additional constructors to support the NonPrime property. 各コンス トラクターは、値の非の素数を保持するだけでなく基底クラスのコンス トラクターを呼び出します。Each constructor calls a base class constructor in addition to preserving the value of the non-prime number. NotPrimeExceptionクラスが指定されても、SerializableAttribute属性。The NotPrimeException class is also marked with the SerializableAttribute attribute.

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; } }
}
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 of Eratosthenes を使用して、クライアントがそのクラス コンス トラクターの呼び出しで指定された制限を 2 から素数のシーケンスを計算します。The PrimeNumberGenerator class shown in the following example uses the Sieve of Eratosthenes to calculate the sequence of prime numbers from 2 to a limit specified by the client in the call to its class constructor. GetPrimesFromメソッドは指定した下限以上であるすべての素数を返しますが、スロー、NotPrimeExceptionその下限の値が素数ではない場合。The GetPrimesFrom method returns all prime numbers that are greater than or equal to a specified lower limit, but throws a NotPrimeException if that lower limit is not a prime number.

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();
   }
}
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

次の例では 2 つの呼び出し、GetPrimesFromメソッドと素数以外をアプリケーション ドメインの境界を越えるうちの 1 つ。The following example makes two calls to the GetPrimesFrom method with non-prime numbers, one of which crosses application domain boundaries. どちらの場合も、例外がスローされ、クライアント コードで正常に処理します。In both cases, the exception is thrown and successfully handled in client code.

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("--------");
      }
   }
}
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 Framework 4.5.1Windows Runtime and .NET Framework 4.5.1.NET Framework 4.5.1

Windows 8.x ストア アプリ用 .NET.NET for Windows 8.x Store appsWindows 8Windows 8、非 .NET Framework のスタック フレームで例外が伝達されるいくつかの例外情報が通常は失われます。In Windows 8.x ストア アプリ用 .NET.NET for Windows 8.x Store apps for Windows 8Windows 8, some exception information is typically lost when an exception is propagated through non-.NET Framework stack frames. 以降では、.NET Framework 4.5.1.NET Framework 4.5.1Windows 8.1Windows 8.1、共通言語ランタイムは引き続き、元の使用Exceptionその例外は、非 .NET Framework のスタック フレームに変更されていない場合にスローされたオブジェクト。Starting with the .NET Framework 4.5.1.NET Framework 4.5.1 and Windows 8.1Windows 8.1, the common language runtime continues to use the original Exception object that was thrown unless that exception was modified in a non-.NET Framework stack frame.

コンストラクター

Exception() Exception() Exception() Exception()

Exception クラスの新しいインスタンスを初期化します。 Initializes a new instance of the Exception class.

Exception(SerializationInfo, StreamingContext) Exception(SerializationInfo, StreamingContext) Exception(SerializationInfo, StreamingContext) Exception(SerializationInfo, StreamingContext)

シリアル化したデータを使用して、Exception クラスの新しいインスタンスを初期化します。 Initializes a new instance of the Exception class with serialized data.

Exception(String) Exception(String) Exception(String) Exception(String)

指定したエラー メッセージを使用して、Exception クラスの新しいインスタンスを初期化します。 Initializes a new instance of the Exception class with a specified error message.

Exception(String, Exception) Exception(String, Exception) Exception(String, Exception) Exception(String, Exception)

指定したエラー メッセージおよびこの例外の原因となった内部例外への参照を使用して、Exception クラスの新しいインスタンスを初期化します。 Initializes a new instance of the Exception class with a specified error message and a reference to the inner exception that is the cause of this exception.

プロパティ

Data Data Data Data

例外に関する追加のユーザー定義情報を提供する、キー/値ペアのコレクションを取得します。 Gets a collection of key/value pairs that provide additional user-defined information about the exception.

HelpLink HelpLink HelpLink HelpLink

この例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 Gets or sets a link to the help file associated with this exception.

HResult HResult HResult HResult

特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

InnerException InnerException InnerException InnerException

現在の例外の原因となる Exception インスタンスを取得します。 Gets the Exception instance that caused the current exception.

Message Message Message Message

現在の例外を説明するメッセージを取得します。 Gets a message that describes the current exception.

Source Source Source Source

エラーの原因となるアプリケーションまたはオブジェクトの名前を取得または設定します。 Gets or sets the name of the application or the object that causes the error.

StackTrace StackTrace StackTrace StackTrace

呼び出し履歴で直前のフレームの文字列形式を取得します。 Gets a string representation of the immediate frames on the call stack.

TargetSite TargetSite TargetSite TargetSite

現在の例外がスローされたメソッドを取得します。 Gets the method that throws the current exception.

方法

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。 Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。 Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

派生クラスでオーバーライドされた場合は、その例外に関する情報を使用して SerializationInfo を設定します。 When overridden in a derived class, sets the SerializationInfo with information about the exception.

GetType() GetType() GetType() GetType()

現在のインスタンスのランタイム型を取得します。 Gets the runtime type of the current instance.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。 Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在の例外の文字列形式を作成して返します。 Creates and returns a string representation of the current exception.

イベント

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

例外がシリアル化され、例外に関するシリアル化されたデータを含む例外状態オブジェクトが作成されたときに発生します。 Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

適用対象

こちらもご覧ください