使用英语阅读

通过

ExceptionHandlingClauseOptions 枚举

  • 参考

定义

命名空间:
System.Reflection
程序集:
System.Runtime.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll

标识异常处理子句的种类。

此枚举支持其成员值的按位组合。

[System.Flags]
public enum ExceptionHandlingClauseOptions
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
public enum ExceptionHandlingClauseOptions
继承
Object
ValueType
Enum
ExceptionHandlingClauseOptions
属性
FlagsAttribute ComVisibleAttribute

字段

名称 值 说明
Clause 0

该子句接受从指定类型派生的所有异常。
Fault 4

该子句在发生异常时执行，而不是在正常控制流完成之后执行。
Filter 1

该子句包含用户指定的指令，这些指令确定是否应忽略异常（即是否应继续正常执行），由关联的处理程序处理异常，还是应将异常传递给下一个子句。
Finally 2

try 块在任何时候退出时，该子句都会执行，无论是通过正常控制流还是因为未经处理的异常。

示例

下面的代码示例定义一个名为 MethodBodyExample的测试方法，并显示其局部变量信息和异常处理子句。 方法 MethodBase.GetMethodBody 用于获取 MethodBody 测试方法的 对象。 属性 ExceptionHandlingClauses 用于获取对象的列表 ExceptionHandlingClause 并显示其属性。

此代码是为 类提供的更大示例的 MethodBody 一部分。

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


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

    }

    // 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.");
            }
        }

        // This filter clause selects only exceptions that derive
        // from the ArgumentException class.
        // Other exceptions, including ArgumentException itself,
        // are not handled by this filter clause.
        catch (ArgumentException ex) when (ex.GetType().IsSubclassOf(typeof(ArgumentException)))
        {
            Console.WriteLine("Filter clause caught: {0}", ex.GetType());
        }

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

//
//Filter
//      Filter Offset: 71
//      Handler Length: 23
//      Handler Offset: 116
//      Try Block Length: 61
//      Try Block Offset: 10
//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

注解

若要检查方法中的异常处理子句，请获取 MethodInfo 对象并调用 GetMethodBody 方法以获取方法正文。 ExceptionHandlingClauses使用 属性获取对象的列表ExceptionHandlingClause。

备注

使用异常处理子句需要全面了解元数据和 Microsoft 中间语言 (MSIL) 指令格式。 可以在 公共语言基础结构 (CLI) 文档中找到信息，尤其是“分区 II：元数据定义和语义”。

适用于

产品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

另请参阅