System.Reflection.Emit.OpCodes.Isinst Field

Tests whether an object reference (type O) is an instance of a particular class.

Syntax

public static readonly OpCode Isinst

Remarks

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

75 < T >

isinst class

Tests if an object reference is an instance of class, returning either a null reference or an instance of that class or interface.

The stack transitional behavior, in sequential order, is:

[The 'ordered' type of list has not been implemented in the ECMA stylesheet.]

Class is a metadata token indicating the desired class. If the class of the object on the top of the stack implements class (if class is an interface) or is a derived class of class (if class is a regular class) then it is cast to type class and the result is pushed on the stack, exactly as though OpCodes.Castclass had been called. Otherwise, a null reference is pushed on the stack. If the object reference itself is a null reference, then isinst likewise returns a null reference.

TypeLoadException is thrown if class cannot be found. This is typically detected when the Microsoft Intermediate Language (MSIL) instructions are converted to native code rather than at runtime.

The following ILGenerator.Emit(OpCode) method overload can use the isinst opcode:

  • ILGenerator.Emit(OpCode, Type)

Requirements

Namespace: System.Reflection.Emit
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0