LocalBuilder.SetLocalSymInfo Method

Definition

Namespace:

System.Reflection.Emit

Assembly:

mscorlib.dll

Sets the local variable's symbolic information.

Overloads

SetLocalSymInfo(String)	Sets the name of this local variable.
SetLocalSymInfo(String, Int32, Int32)	Sets the name and lexical scope of this local variable.

SetLocalSymInfo(String)

Sets the name of this local variable.

public:
 void SetLocalSymInfo(System::String ^ name);

public void SetLocalSymInfo (string name);

member this.SetLocalSymInfo : string -> unit

Public Sub SetLocalSymInfo (name As String)

Parameters

name

String

The name of the local variable.

Exceptions

InvalidOperationException

The containing type has been created with CreateType().

-or-

There is no symbolic writer defined for the containing module.

NotSupportedException

This local is defined in a dynamic method, rather than in a method of a dynamic type.

Examples

The following code sample illustrates the use of the SetLocalSymInfo method. This code is part of a larger example for the LocalBuilder class.

// Create local variables named myString and myInt.
LocalBuilder^ myLB1 = myMethodIL->DeclareLocal( String::typeid );
myLB1->SetLocalSymInfo( "myString" );
Console::WriteLine( "local 'myString' type is: {0}", myLB1->LocalType );

LocalBuilder^ myLB2 = myMethodIL->DeclareLocal( int::typeid );
myLB2->SetLocalSymInfo( "myInt", 1, 2 );
Console::WriteLine( "local 'myInt' type is: {0}", myLB2->LocalType );

// Create local variables named myString and myInt.
LocalBuilder myLB1 = myMethodIL.DeclareLocal(typeof(string));
myLB1.SetLocalSymInfo("myString");
Console.WriteLine("local 'myString' type is: {0}", myLB1.LocalType);

LocalBuilder myLB2 = myMethodIL.DeclareLocal(typeof(int));
myLB2.SetLocalSymInfo("myInt", 1, 2);
Console.WriteLine("local 'myInt' type is: {0}", myLB2.LocalType);

' Create local variables named myString and myInt.
Dim myLB1 As LocalBuilder = myMethodIL.DeclareLocal(GetType(String))
myLB1.SetLocalSymInfo("myString")
Console.WriteLine("local 'myString' type is: {0}", myLB1.LocalType)

Dim myLB2 As LocalBuilder = myMethodIL.DeclareLocal(GetType(Integer))
myLB2.SetLocalSymInfo("myInt", 1, 2)
Console.WriteLine("local 'myInt' type is: {0}", myLB2.LocalType)

Remarks

The SetLocalSymInfo method is supported for methods defined in dynamic types. It is not supported for dynamic methods defined using the DynamicMethod class.

SetLocalSymInfo(String, Int32, Int32)

Sets the name and lexical scope of this local variable.

public:
 void SetLocalSymInfo(System::String ^ name, int startOffset, int endOffset);

public void SetLocalSymInfo (string name, int startOffset, int endOffset);

member this.SetLocalSymInfo : string * int * int -> unit

Public Sub SetLocalSymInfo (name As String, startOffset As Integer, endOffset As Integer)

Parameters

name

String

The name of the local variable.

startOffset

Int32

The beginning offset of the lexical scope of the local variable.

endOffset

Int32

The ending offset of the lexical scope of the local variable.

Exceptions

InvalidOperationException

The containing type has been created with CreateType().

-or-

There is no symbolic writer defined for the containing module.

NotSupportedException

This local is defined in a dynamic method, rather than in a method of a dynamic type.

Examples

The following code sample illustrates the use of the SetLocalSymInfo method. This code is part of a larger example for the LocalBuilder class.

// Create local variables named myString and myInt.
LocalBuilder^ myLB1 = myMethodIL->DeclareLocal( String::typeid );
myLB1->SetLocalSymInfo( "myString" );
Console::WriteLine( "local 'myString' type is: {0}", myLB1->LocalType );

LocalBuilder^ myLB2 = myMethodIL->DeclareLocal( int::typeid );
myLB2->SetLocalSymInfo( "myInt", 1, 2 );
Console::WriteLine( "local 'myInt' type is: {0}", myLB2->LocalType );

// Create local variables named myString and myInt.
LocalBuilder myLB1 = myMethodIL.DeclareLocal(typeof(string));
myLB1.SetLocalSymInfo("myString");
Console.WriteLine("local 'myString' type is: {0}", myLB1.LocalType);

LocalBuilder myLB2 = myMethodIL.DeclareLocal(typeof(int));
myLB2.SetLocalSymInfo("myInt", 1, 2);
Console.WriteLine("local 'myInt' type is: {0}", myLB2.LocalType);

' Create local variables named myString and myInt.
Dim myLB1 As LocalBuilder = myMethodIL.DeclareLocal(GetType(String))
myLB1.SetLocalSymInfo("myString")
Console.WriteLine("local 'myString' type is: {0}", myLB1.LocalType)

Dim myLB2 As LocalBuilder = myMethodIL.DeclareLocal(GetType(Integer))
myLB2.SetLocalSymInfo("myInt", 1, 2)
Console.WriteLine("local 'myInt' type is: {0}", myLB2.LocalType)

Remarks

The SetLocalSymInfo method is supported for methods defined in dynamic types. It is not supported for dynamic methods defined using the DynamicMethod class.