This documentation is archived and is not being maintained.

OpCodes.Leave_S Field

Exits a protected region of code, unconditionally tranferring control to a target instruction (short form).

[Visual Basic]
Public Shared ReadOnly Leave_S As OpCode
[C#]
public static readonly OpCode Leave_S;
[C++]
public: static OpCode Leave_S;
[JScript]
public static var Leave_S : OpCode;

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
DE < int8 > leave.s target Exit a protected region of code, short form.

There is no stack transition behavior specified for this instruction.

The leave.s instruction unconditionally transfers control to the passed target instruction, represented as a 1-byte signed offset from the beginning of the instruction following the current instruction.

The leave.s instruction is similar to the br instruction, but it can be used to exit a try, filter, or catch block whereas the ordinary branch instructions can only be used in such a block to transfer control within it. The leave.s instruction empties the evaluation stack and ensures that the appropriate surrounding finally blocks are executed.

You cannot use a leave.s instruction to exit a finally block. To ease code generation for exception handlers it is valid from within a catch block to use a leave.s instruction to transfer control to any instruction within the associated try block.

If an instruction has one or more prefix codes, control can only be transferred to the first of these prefixes.

The following Emit constructor overload can use the leave.s opcode:

  • ILGenerator.Emit(OpCode, Label)

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

OpCodes Class | OpCodes Members | System.Reflection.Emit Namespace

Show: