Type.IsInstanceOfType Method (Object)

 

Determines whether the specified object is an instance of the current Type.

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

Public Overridable Function IsInstanceOfType (
	o As Object
) As Boolean

Parameters

o
Type: System.Object

The object to compare with the current type.

Return Value

Type: System.Boolean

true if the current Type is in the inheritance hierarchy of the object represented by o, or if the current Type is an interface that o implements. false if neither of these conditions is the case, if o is null, or if the current Type is an open generic type (that is, ContainsGenericParameters returns true).

This method can be overridden by a derived class.

System_CAPS_noteNote

A constructed type is not an instance of its generic type definition. That is, MyGenericList<int> (MyGenericList(Of Integer) in Visual Basic) is not an instance of MyGenericList<T> (MyGenericList(Of T) in Visual Basic).

The following example demonstrates the use of the IsInstanceOfType method.

Public Interface IExample
End Interface

Public Class BaseClass : Implements IExample
End Class

Public Class DerivedClass : Inherits BaseClass
End Class

Public Module Example
    Public Sub Main()
        Dim interfaceType As Type = GetType(IExample)
        Dim base1 As New BaseClass()
        Dim base1Type As Type = base1.GetType()
        Dim derived1 = New DerivedClass()
        Dim derived1Type As Type = derived1.GetType()
        Dim arr(10) As Integer

        Console.WriteLine("Is int[] an instance of the Array class? {0}.",
                           GetType(Array).IsInstanceOfType(arr))
        Console.WriteLine("Is base1 an instance of BaseClass? {0}.",
                          base1Type.IsInstanceOfType(base1))
        Console.WriteLine("Is derived1 an instance of BaseClass? {0}.",
                          base1Type.IsInstanceOfType(derived1))
        Console.WriteLine("Is base1 an instance of IExample? {0}.",
                          interfaceType.IsInstanceOfType(base1))
        Console.WriteLine("Is derived1 an instance of IExample? {0}.",
                          interfaceType.IsInstanceOfType(derived1))
    End Sub
End Module
' The example displays the following output:
'    Is int[] an instance of the Array class? True.
'    Is base1 an instance of BaseClass? True.
'    Is derived1 an instance of BaseClass? True.
'    Is base1 an instance of IExample? True.
'    Is derived1 an instance of IExample? True.

.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: