OpCodes.Ldarg Field

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Loads an argument (referenced by a specified index value) onto the stack.

Namespace:  System.Reflection.Emit
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared ReadOnly Ldarg As OpCode
public static readonly OpCode Ldarg

Remarks

The following table lists the instruction's hexadecimal and Microsoft intermediate language (MSIL) assembly format, along with a brief reference summary:

Format

Assembly Format

Description

FE 09 < unsigned int16 >

ldarg index

Load argument at index onto stack.

The stack transitional behavior, in sequential order, is:

  1. The argument value at index is pushed onto the stack.

The ldarg instruction pushes the argument indexed at index, where arguments are indexed from 0 onwards, onto the evaluation stack. The ldarg instruction can be used to load a value type or a primitive value onto the stack by copying it from an incoming argument. The type of the argument value is the same as the type of the argument, as specified by the current method's signature.

For procedures that take a variable-length argument list, the ldarg instruction can be used only for the initial fixed arguments, not those in the variable part of the signature (see the Arglist instruction for more details).

Arguments that hold an integer value smaller than 4 bytes long are expanded to type int32 when they are loaded onto the stack. Floating-point values are expanded to their native size (type F).

The following Emit method overload can use the ldarg opcode:

  • ILGenerator.Emit(OpCode, short)

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.