Partager via


OpCodes.Conv_Ovf_U1 Field

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

Converts the signed value on top of the evaluation stack to unsigned int8 and extends it to int32, throwing OverflowException on overflow.

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

Syntax

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

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

B4

conv.ovf.u1

Convert to an unsigned int8 (on the stack as int32) and throw an exception on overflow.

The stack transitional behavior, in sequential order, is:

  1. value is pushed onto the stack.

  2. value is popped from the stack and the conversion operation is attempted. If overflow occurs, an exception is thrown.

  3. If the conversion is successful, the resulting value is pushed onto the stack.

The conv.ovf.u1 opcode converts the value on top of the stack to the type specified in the opcode, and places that converted value on the top of the stack. If the value is too large or too small to be represented by the target type, an exception is thrown.

Conversions from floating-point numbers to integer values truncate the number toward zero. Note that integer values of less than 4 bytes are extended to int32 when they are loaded onto the evaluation stack (unless conv.ovf.i or conv.ovf.u are used, in which case the result is also native int).

OverflowException is thrown if the result can not be represented in the result type.

The following Emit method overload can use the conv.ovf.u1 opcode:

  • ILGenerator.Emit(OpCode)

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.