LocalVariableInfo

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

LocalVariableInfo クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ローカル変数の属性を取得し、ローカル変数のメタデータにアクセスできるようにします。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Class LocalVariableInfo

Visual Basic (使用法)

Dim instance As LocalVariableInfo

C#

[ComVisibleAttribute(true)] 
public class LocalVariableInfo

C++

[ComVisibleAttribute(true)] 
public ref class LocalVariableInfo

J#

/** @attribute ComVisibleAttribute(true) */ 
public class LocalVariableInfo

JScript

ComVisibleAttribute(true) 
public class LocalVariableInfo

解説

メソッド内のローカル変数の一覧を取得するには、MethodBody クラスの LocalVariables プロパティを使用します。GetMethodBody メソッドを使用して、MethodInfo オブジェクトの MethodBody を取得します。

メモ
ローカル変数名は、メタデータ内で永続化されません。MSIL (Microsoft Intermediate Language) では、ローカル変数にはローカル変数シグネチャ内での位置によってアクセスします。

使用例

MethodBodyExample という名前のテスト メソッドを定義し、ローカル変数の情報を表示するコード例を次に示します。MethodBase.GetMethodBody メソッドを使用して、テスト メソッドの MethodBody オブジェクトを取得します。次に、MethodBody.LocalVariables プロパティを使用して、LocalVariableInfo オブジェクトの一覧を取得し、その型とインデックス順を表示します。

このコード例は、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 information about the local variables in the
        ' method body.
        Console.WriteLine()
        For Each lvi As
 LocalVariableInfo In mb.LocalVariables
            Console.WriteLine("Local variable: {0}",
 lvi)
        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
 />'
'Local variable: System.Int32 (0)
'Local variable: System.String (1)
'Local variable: System.ArgumentException (2)
'Local variable: System.Exception (3)

C#

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

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 information about the local variables in the
    // method body.
    Console::WriteLine();
    for each (LocalVariableInfo^ lvi in mb->LocalVariables)
    {
        Console::WriteLine("Local variable: {0}", lvi);
    }
<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.";
        }
    }
<br /><span space="preserve">...</span><br />//Local
 variable: System.ArgumentException (0)
//Local variable: System.String (1)
//Local variable: System.Int32 (2)

継承階層

System.Object
  System.Reflection.LocalVariableInfo
     System.Reflection.Emit.LocalBuilder

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
LocalVariableInfo メンバ
System.Reflection 名前空間
MethodBody.LocalVariables

LocalVariableInfo プロパティ

パブリック プロパティ

	名前	説明
	IsPinned	ローカル変数が参照するオブジェクトがメモリに固定されているかどうかを示す Boolean 値を取得します。
	LocalIndex	メソッド本体内のローカル変数のインデックスを取得します。
	LocalType	ローカル変数の型を取得します。

参照

関連項目

LocalVariableInfo クラス
System.Reflection 名前空間
MethodBody.LocalVariables

LocalVariableInfo メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーライドされます。 ユーザーが判読できる、ローカル変数を示す文字列を返します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

LocalVariableInfo クラス
System.Reflection 名前空間
MethodBody.LocalVariables

LocalVariableInfo メンバ

ローカル変数の属性を取得し、ローカル変数のメタデータにアクセスできるようにします。

LocalVariableInfo データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	IsPinned	ローカル変数が参照するオブジェクトがメモリに固定されているかどうかを示す Boolean 値を取得します。
	LocalIndex	メソッド本体内のローカル変数のインデックスを取得します。
	LocalType	ローカル変数の型を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーライドされます。 ユーザーが判読できる、ローカル変数を示す文字列を返します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

LocalVariableInfo クラス
System.Reflection 名前空間
MethodBody.LocalVariables