Is Operator (Visual Basic)
Compares two object reference variables.
result = object1 Is object2
Parts
result
Required. Any Boolean value.object1
Required. Any Object name.object2
Required. Any Object name.
Remarks
The Is operator determines if two object references refer to the same object. However, it does not perform value comparisons. If object1 and object2 both refer to the exact same object instance, result is True; if they do not, result is False.
Is can also be used with the TypeOf keyword to make a TypeOf...Is expression, which tests whether an object variable is compatible with a data type.
Note
The Is keyword is also used in the Select...Case Statement (Visual Basic).
Example
The following example uses the Is operator to compare pairs of object references. The results are assigned to a Boolean value representing whether the two objects are identical.
Dim myObject As New Object
Dim otherObject As New Object
Dim yourObject, thisObject, thatObject As Object
Dim myCheck As Boolean
yourObject = myObject
thisObject = myObject
thatObject = otherObject
' The following statement sets myCheck to True.
myCheck = yourObject Is thisObject
' The following statement sets myCheck to False.
myCheck = thatObject Is thisObject
' The following statement sets myCheck to False.
myCheck = myObject Is thatObject
thatObject = myObject
' The following statement sets myCheck to True.
myCheck = thisObject Is thatObject
As the preceding example demonstrates, you can use the Is operator to test both early bound and late bound objects.
See Also
Reference
TypeOf Operator (Visual Basic)
Operator Precedence in Visual Basic
Operators Listed by Functionality (Visual Basic)