OpCodes.Isinst Field
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.
Tests whether an object reference (type O
) is an instance of a particular class.
public: static initonly System::Reflection::Emit::OpCode Isinst;
public static readonly System.Reflection.Emit.OpCode Isinst;
staticval mutable Isinst : System.Reflection.Emit.OpCode
Public Shared ReadOnly Isinst As OpCode
Field Value
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 |
---|---|---|
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:
An object reference is pushed onto the stack.
The object reference is popped from the stack and tested to see if it is an instance of the class passed in
class
.The result (either an object reference or a null reference) is pushed onto the stack.
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 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 Emit method overload can use the isinst
opcode: