Is Operator (Visual Basic)

Compares two object reference variables.

Syntax

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.

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

TypeOf Operator
IsNot Operator
Comparison Operators in Visual Basic
Operator Precedence in Visual Basic
Operators Listed by Functionality
Operators and Expressions