ExceptionHandlingClause.CatchType プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ExceptionHandlingClause.CatchType プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

この句によって処理される例外の種類を取得します。

名前空間: System.Reflection
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 CatchType As Type

Visual Basic (使用法)

Dim instance As ExceptionHandlingClause
Dim value As Type

value = instance.CatchType

public Type CatchType { get; }

C++

public:
property Type^ CatchType {
    Type^ get ();
}

/** @property */
public Type get_CatchType ()

JScript

public function get CatchType
 () : Type

プロパティ値
この句によって処理される例外の種類を表す Type オブジェクト。Flags プロパティが ExceptionHandlingClauseOptions.Filter または ExceptionHandlingClauseOptions.Finally である場合は null 参照 (Visual Basic では Nothing)。

解説

メモ
例外処理句を処理するには、メタデータと MSIL (Microsoft Intermediate Language) の命令書式について十分に理解している必要があります。この情報については、共通言語基盤 (CLI: Common Language Infrastructure) のドキュメント、特に「Partition II: Metadata Definition and Semantics」と「Partition III: CIL Instruction Set」を参照してください。このドキュメントは、http://msdn.microsoft.com/net/ecma/ および http://www.ecma-international.org/publications/standards/Ecma-335.htm で入手できます。

メモ

例外処理句を処理するには、メタデータと MSIL (Microsoft Intermediate Language) の命令書式について十分に理解している必要があります。この情報については、共通言語基盤 (CLI: Common Language Infrastructure) のドキュメント、特に「Partition II: Metadata Definition and Semantics」と「Partition III: CIL Instruction Set」を参照してください。このドキュメントは、http://msdn.microsoft.com/net/ecma/ および http://www.ecma-international.org/publications/standards/Ecma-335.htm で入手できます。

使用例

MethodBodyExample という名前のテストメソッドを定義し、ローカル変数の情報および例外処理句を表示するコード例を次に示します。MethodBase.GetMethodBody メソッドを使用して、テストメソッドの MethodBody オブジェクトを取得します。ExceptionHandlingClauses プロパティは、ExceptionHandlingClause オブジェクトの一覧を取得し、それらのプロパティを表示するために使用されます。

メモ
すべてのコンピュータ言語が ExceptionHandlingClauseOptions.Filter 句を生成できるわけではありません。Visual Basic の例では、Visual Basic の When 式による filter 句が使用されています (他の言語の例では省略されています)。

このコードは、MethodBody クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Imports System
Imports System.Reflection

Public Class Example

    Public Shared Sub Main()

        ' Demonstrate the effect of the Visual Basic When keyword, which
        ' generates a Filter clause in the Try block.
        Dim e As New Example()
        Console.WriteLine()
        e.MethodBodyExample("String argument")
        e.MethodBodyExample(Nothing)

        ' Get method body information.
        Dim mi As MethodInfo = _
            GetType(Example).GetMethod("MethodBodyExample")
        Dim mb As MethodBody = mi.GetMethodBody()
        Console.WriteLine(vbCrLf & "Method: {0}",
 mi)

        ' Display the general information included in the 
        ' MethodBody object.
        Console.WriteLine("    Local variables are initialized:
 {0}", _
            mb.InitLocals)
        Console.WriteLine("    Maximum number of items on the
 operand stack: {0}", _
            mb.MaxStackSize)
<br /><span space="preserve">...</span><br
 />
        ' Display exception handling clauses.
        Console.WriteLine()
        For Each ehc As
 ExceptionHandlingClause In mb.ExceptionHandlingClauses
            Console.WriteLine(ehc.Flags.ToString())

            ' The FilterOffset property is meaningful only for Filter
            ' clauses. The CatchType property is not meaningful for
 
            ' Filter or Finally clauses. 
            Select Case ehc.Flags
                Case ExceptionHandlingClauseOptions.Filter
                    Console.WriteLine("        Filter Offset:
 {0}", _
                        ehc.FilterOffset)
                Case ExceptionHandlingClauseOptions.Finally
                Case Else
                    Console.WriteLine("    Type of exception:
 {0}", _
                        ehc.CatchType)
            End Select

            Console.WriteLine("       Handler Length: {0}",
 ehc.HandlerLength)
            Console.WriteLine("       Handler Offset: {0}",
 ehc.HandlerOffset)
            Console.WriteLine("     Try Block Length: {0}",
 ehc.TryLength)
            Console.WriteLine("     Try Block Offset: {0}",
 ehc.TryOffset)
        Next
<br /><span space="preserve">...</span><br
 />    End Sub

    ' This test method is executed at the beginning of Main, to show
    ' how the Filter clause works. The Filter clause is generated by
 
    ' a Visual Basic When expression. If arg is Nothing, this method
    ' throws ArgumentNullException, which is caught by the filter
    ' clause. If arg is a string, the method throws ArgumentException
,
    ' which does not match the filter clause.
    '
    ' Sub Main also contains code to analyze this method, using 
    ' the properties and methods of the MethodBody class.
    Public Sub MethodBodyExample(ByVal
 arg As Object)

        ' Define some local variables. In addition to these variables
,
        ' the local variable list includes the variables scoped to 
        ' the catch clauses.
        Dim var1 As Integer
 = 42
        Dim var2 As String
 = "Forty-two"

        Try
            ' Depending on the input value, throw an ArgumentException
 or 
            ' an ArgumentNullException to test the Catch clauses.
            '
            If arg Is Nothing
 Then
                Throw New ArgumentNullException("The
 argument cannot be Nothing.")
            End If
            If arg.GetType() Is GetType(String)
 Then
                Throw New ArgumentException("The
 argument cannot be a string.")
            End If
        
        ' The When expression makes this a filter clause. The expression
 
        ' selects only exceptions that derive from the ArgumentException
        ' class. Other exceptions, including ArgumentException itself,
 
        ' are not handled by this filter clause.
        Catch ex As ArgumentException _
            When ex.GetType().IsSubclassOf(GetType(ArgumentException))

            Console.WriteLine("Filter clause caught: {0}",
 ex.GetType())
        
        ' This catch clause handles the ArgumentException class, and
        ' any other class derived from Exception.
        Catch ex As Exception
            Console.WriteLine("Ordinary exception-handling clause
 caught: {0}", _
                ex.GetType())

        Finally
            var1 = 3033
            var2 = "Another string."
        End Try
    End Sub
End Class

' This code example produces output similar to the following:
'
'Ordinary exception-handling clause caught: System.ArgumentException
'Filter clause caught: System.ArgumentNullException
'
'Method: Void MethodBodyExample(System.Object)
'    Local variables are initialized: True
'    Maximum number of items on the operand stack: 3
<br /><span space="preserve">...</span><br
 />'
'Filter
'        Filter Offset: 0
'       Handler Length: 19
'       Handler Offset: 99
'     Try Block Length: 45
'     Try Block Offset: 9
'Clause
'    Type of exception: System.Exception
'       Handler Length: 25
'       Handler Offset: 118
'     Try Block Length: 45
'     Try Block Offset: 9
'Finally
'       Handler Length: 13
'       Handler Offset: 153
'     Try Block Length: 144
'     Try Block Offset: 9

using System;
using System.Reflection;

public class Example
{
    public static void Main()
    {
        // Get method body information.
        MethodInfo mi = typeof(Example).GetMethod("MethodBodyExample");
        MethodBody mb = mi.GetMethodBody();
        Console.WriteLine("\r\nMethod: {0}", mi);

        // Display the general information included in the 
        // MethodBody object.
        Console.WriteLine("    Local variables are initialized: {0}", 
            mb.InitLocals);
        Console.WriteLine("    Maximum number of items on the operand stack:
 {0}", 
            mb.MaxStackSize);
<br /><span space="preserve">...</span><br />
        // Display exception handling clauses.
        Console.WriteLine();
        foreach (ExceptionHandlingClause ehc in
 mb.ExceptionHandlingClauses)
        {
            Console.WriteLine(ehc.Flags.ToString());

            // The FilterOffset property is meaningful only for Filter
            // clauses. The CatchType property is not meaningful for
 
            // Filter or Finally clauses. 
            switch (ehc.Flags)
            {
                case ExceptionHandlingClauseOptions.Filter:
                    Console.WriteLine("        Filter Offset: {0}", 
                        ehc.FilterOffset);
                    break;
                case ExceptionHandlingClauseOptions.Finally:
                    break;
                default:
                    Console.WriteLine("    Type of exception: {0}", 
                        ehc.CatchType);
                    break;
            }

            Console.WriteLine("       Handler Length: {0}", ehc.HandlerLength);
            Console.WriteLine("       Handler Offset: {0}", ehc.HandlerOffset);
            Console.WriteLine("     Try Block Length: {0}", ehc.TryLength);
            Console.WriteLine("     Try Block Offset: {0}", ehc.TryOffset);
        }
<br /><span space="preserve">...</span><br /> 
   }

    // The Main method contains code to analyze this method, using
    // the properties and methods of the MethodBody class.
    public void MethodBodyExample(object arg)
    {
        // Define some local variables. In addition to these variables
,
        // the local variable list includes the variables scoped to
 
        // the catch clauses.
        int var1 = 42;
        string var2 = "Forty-two";

        try
        {
            // Depending on the input value, throw an ArgumentException
 or 
            // an ArgumentNullException to test the Catch clauses.
            if (arg == null)
            {
                throw new ArgumentNullException("The argument
 cannot be null.");
            }
            if (arg.GetType() == typeof(string))
            {
                throw new ArgumentException("The argument
 cannot be a string.");
            }        
        }

        // There is no Filter clause in this code example. See the Visual
 
        // Basic code for an example of a Filter clause.

        // This catch clause handles the ArgumentException class, and
        // any other class derived from Exception.
        catch(Exception ex)
        {
            Console.WriteLine("Ordinary exception-handling clause caught: {0}",
 
                ex.GetType());
        }        
        finally
        {
            var1 = 3033;
            var2 = "Another string.";
        }
    }
}

// This code example produces output similar to the following:
//
//Method: Void MethodBodyExample(System.Object)
//    Local variables are initialized: True
//    Maximum number of items on the operand stack: 2
<br /><span space="preserve">...</span><br />//
//Clause
//    Type of exception: System.Exception
//       Handler Length: 21
//       Handler Offset: 70
//     Try Block Length: 61
//     Try Block Offset: 9
//Finally
//       Handler Length: 14
//       Handler Offset: 94
//     Try Block Length: 85
//     Try Block Offset: 9

C++

#using <System.dll>

using namespace System;
using namespace System::Reflection;

public ref class Example
{
    // The Main method contains code to analyze this method, using
    // the properties and methods of the MethodBody class.
public:
    void MethodBodyExample(Object^ arg)
    {
        // Define some local variables. In addition to these variables
,
        // the local variable list includes the variables scoped to
 
        // the catch clauses.
        int var1 = 42;
        String^ var2 = "Forty-two";

        try
        {
            // Depending on the input value, throw an ArgumentException
 or 
            // an ArgumentNullException to test the Catch clauses.
            if (arg == nullptr)
            {
                throw gcnew ArgumentNullException("The argument cannot "
 +
                    "be null.");
            }
            if (arg->GetType() == String::typeid)
            {
                throw gcnew ArgumentException("The argument cannot " +
 
                    "be a string.");
            }        
        }

        // There is no Filter clause in this code example. See the Visual
 
        // Basic code for an example of a Filter clause.

        // This catch clause handles the ArgumentException class, and
        // any other class derived from Exception.
        catch (ArgumentException^ ex)
        {
            Console::WriteLine("Ordinary exception-handling clause caught:"
 +
                " {0}", ex->GetType());
        }        
        finally
        {
            var1 = 3033;
            var2 = "Another string.";
        }
    }
};

int main()
{ 
    // Get method body information.
    MethodInfo^ mi = 
        Example::typeid->GetMethod("MethodBodyExample");

    MethodBody^ mb = mi->GetMethodBody();
    Console::WriteLine("\r\nMethod: {0}", mi);

    // Display the general information included in the 
    // MethodBody object.
    Console::WriteLine("    Local variables are initialized: {0}", 
        mb->InitLocals);
    Console::WriteLine("    Maximum number of items on the operand " +
        "stack: {0}", mb->MaxStackSize);
<br /><span space="preserve">...</span><br />
    // Display exception handling clauses.
    Console::WriteLine();
    for each(ExceptionHandlingClause^ exhc in
 mb->ExceptionHandlingClauses)
    {
        Console::WriteLine(exhc->Flags.ToString());

        // The FilterOffset property is meaningful only for Filter
        // clauses. The CatchType property is not meaningful for 
        // Filter or Finally clauses. 
        switch(exhc->Flags)
        {
        case ExceptionHandlingClauseOptions::Filter:
            Console::WriteLine("        Filter Offset: {0}", 
                exhc->FilterOffset);
            break;
        case ExceptionHandlingClauseOptions::Finally:
            break;
        default:
            Console::WriteLine("    Type of exception: {0}", 
                exhc->CatchType);
            break;
        }

        Console::WriteLine("       Handler Length: {0}",
            exhc->HandlerLength);
        Console::WriteLine("       Handler Offset: {0}", 
            exhc->HandlerOffset);
        Console::WriteLine("     Try Block Length: {0}", exhc->TryLength);
        Console::WriteLine("     Try Block Offset: {0}", exhc->TryOffset);
    }
<br /><span space="preserve">...</span><br /> 
   // The Main method contains code to analyze this method, using
    // the properties and methods of the MethodBody class.
public:
    void MethodBodyExample(Object^ arg)
    {
        // Define some local variables. In addition to these variables
,
        // the local variable list includes the variables scoped to
 
        // the catch clauses.
        int var1 = 42;
        String^ var2 = "Forty-two";

        try
        {
            // Depending on the input value, throw an ArgumentException
 or 
            // an ArgumentNullException to test the Catch clauses.
            if (arg == nullptr)
            {
                throw gcnew ArgumentNullException("The argument cannot "
 +
                    "be null.");
            }
            if (arg->GetType() == String::typeid)
            {
                throw gcnew ArgumentException("The argument cannot " +
 
                    "be a string.");
            }        
        }

        // There is no Filter clause in this code example. See the Visual
 
        // Basic code for an example of a Filter clause.

        // This catch clause handles the ArgumentException class, and
        // any other class derived from Exception.
        catch (ArgumentException^ ex)
        {
            Console::WriteLine("Ordinary exception-handling clause caught:"
 +
                " {0}", ex->GetType());
        }        
        finally
        {
            var1 = 3033;
            var2 = "Another string.";
        }
    }

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ExceptionHandlingClause クラス
ExceptionHandlingClause メンバ
System.Reflection 名前空間

このページでは「.NET Framework クラスライブラリリファレンス」からExceptionHandlingClause.CatchType プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からExceptionHandlingClause.CatchType プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からExceptionHandlingClause.CatchType プロパティを検索

>> 「ExceptionHandlingClause.CatchType プロパティ」を含む用語の索引
ExceptionHandlingClause.CatchType プロパティのページへのリンク


	© 2025 Microsoft.All rights reserved.

ExceptionHandlingClause.CatchType プロパティとは？ わかりやすく解説

ExceptionHandlingClause.CatchType プロパティ

急上昇のことば

ExceptionHandlingClause.CatchType プロパティとは？わかりやすく解説