Object Variables in Visual Basic


Updated: July 20, 2015

For the latest documentation on Visual Studio 2017, see Visual Studio 2017 Documentation.

In addition to storing values directly, a variable can refer to an object. You assign an object to a variable for the same reasons you assign any value to a variable:

  • A variable name is often shorter and easier to remember than the full path of methods and properties necessary to access the object itself.

  • Using a variable that refers to an object is more efficient than repeatedly accessing the object itself through the necessary methods or properties.

  • You can change a variable to refer to other objects while your code is running.

You can use object variables to shorten the code you have to type. The following example uses the full path of methods and properties to access a Control object.

' Assume Me is a valid Form, or replace Me with a valid Form.  
Me.ActiveForm.ActiveControl.Text = "Test"  
Me.ActiveForm.ActiveControl.Location = New Point(100, 100)  

You can shorten this code, and speed up execution, if you use an object variable for the control. You should declare the object variable with the specific class that you intend to assign to it (Control in this case). Once you assign an object to the variable, you can treat it exactly the same as you treat the object to which it refers. You can set or retrieve the properties of the object or use any of its methods. The following example uses an object variable to simplify the code in the preceding example.

Dim ctrlActv As System.Windows.Forms.Control = Me.ActiveForm.ActiveControl  
ctrlActv.Text = "Test"  
ctrlActv.Location = New Point(100, 100)  

Variable Declaration
How to: Speed Up Access to an Object with a Long Qualification Path
Object Variable Declaration
Object Variable Assignment
Object Variable Values