LocalBuilder.SetLocalSymInfo Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 -> unitPublic Sub SetLocalSymInfo (name As String)Parameters
- name
- String
The name of the local variable.
Exceptions
The containing type has been created with CreateType().
-or-
There is no symbolic writer defined for the containing module.
This local is defined in a dynamic method, rather than in a method of a dynamic type.
The name is null.
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.
Applies to
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 -> unitPublic 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
The containing type has been created with CreateType().
-or-
There is no symbolic writer defined for the containing module.
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.
