MethodBody 类

定义

提供对方法体的元数据和 MSIL 的访问权限。

public class MethodBody
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class MethodBody
[System.Runtime.InteropServices.ComVisible(true)]
public class MethodBody
继承
MethodBody
属性

示例

下面的代码示例定义名为 MethodBodyExample 的测试方法,并显示其本地变量信息和异常处理子句。 方法 MethodBase.GetMethodBody 用于获取 MethodBody 测试方法的对象。

该示例使用 LocalVariables 属性获取对象的列表, LocalVariableInfo 然后显示其类型和索引顺序。 属性 ExceptionHandlingClauses 用于获取异常处理子句的列表。

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 information about the local variables in the
        // method body.
        Console.WriteLine();
        foreach (LocalVariableInfo lvi in mb.LocalVariables)
        {
            Console.WriteLine("Local variable: {0}", lvi);
        }

        // 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
//
//Local variable: System.Int32 (0)
//Local variable: System.String (1)
//Local variable: System.Exception (2)
//Local variable: System.Boolean (3)
//
//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

注解

MethodBody 提供对方法正文中局部变量和异常处理子句的信息的访问,以及构成方法正文的 Microsoft 中间语言 (MSIL) 。

可以使用模块类的令牌解析方法(如 ResolveTypeResolveMethodResolveType)将方法主体中的令牌解析为 Type 对象、 MethodInfo 对象和 FieldInfo 对象,这些对象提供有关 MSIL 在方法正文中访问的类型、方法和字段的详细信息。

备注

分析方法主体需要全面了解元数据和 MSIL 指令格式。 可以在 公共语言基础结构 (CLI) 文档中找到信息,尤其是“分区 II:元数据定义和语义”。

若要获取 MethodBody 给定方法的对象,请先获取 MethodInfo 方法的对象,然后调用 对象的 MethodInfoGetMethodBody 方法。

构造函数

MethodBody()

初始化 MethodBody 类的新实例。

属性

ExceptionHandlingClauses

获取在方法主体中包含所有异常处理的子句的列表。

InitLocals

获取一个值,该值指示方法体中的局部变量是否初始化为相应类型的默认值。

LocalSignatureMetadataToken

获取签名的元数据标记,该签名描述元数据中的方法的局部变量。

LocalVariables

获取方法体中声明的局部变量的列表。

MaxStackSize

执行方法时,获取操作堆栈上的项的最大数目。

方法

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetILAsByteArray()

以字节数组的形式返回用于方法体的 MSIL。

GetType()

获取当前实例的 Type

(继承自 Object)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
ToString()

返回表示当前对象的字符串。

(继承自 Object)

适用于

产品 版本
.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