How to: Call a Property Procedure (Visual Basic)

You call a property procedure by storing a value in the property or retrieving its value. You access a property the same way you access a variable.

The property's Set procedure stores a value, and its Get procedure retrieves the value. However, you do not explicitly call these procedures by name. You use the property in an assignment statement or an expression, just as you would store or retrieve the value of a variable. Visual Basic makes the calls to the property's procedures.

To call a property's Get procedure

1. Use the property name in an expression the same way you would use a variable name. You can use a property anywhere you can use a variable or a constant.

   -or-

   Use the property name following the equal (=) sign in an assignment statement.

   The following example reads the value of the Now property, implicitly calling its Get procedure.

   Dim ThisMoment As Date 
   ' The following statement calls the Get procedure of the Visual Basic Now property.
   ThisMoment = Now
   

2. If the property takes arguments, follow the property name with parentheses to enclose the argument list. If there are no arguments, you can optionally omit the parentheses.

3. Place the arguments in the argument list within the parentheses, separated by commas. Be sure you supply the arguments in the same order that the property defines the corresponding parameters.

The value of the property participates in the expression just as a variable or constant would, or it is stored in the variable or property on the left side of the assignment statement.

To call a property's Set procedure

1. Use the property name on the left side of an assignment statement.

   The following example sets the value of the TimeOfDay property, implicitly calling the Set procedure.

   ' The following statement calls the Set procedure of the Visual Basic TimeOfDay property.
   TimeOfDay = #12:00:00 PM#
   

2. If the property takes arguments, follow the property name with parentheses to enclose the argument list. If there are no arguments, you can optionally omit the parentheses.

3. Place the arguments in the argument list within the parentheses, separated by commas. Be sure you supply the arguments in the same order that the property defines the corresponding parameters.

The value generated on the right side of the assignment statement is stored in the property.

See Also

Tasks

How to: Create a Property (Visual Basic)

How to: Declare a Property with Mixed Access Levels (Visual Basic)

How to: Declare and Call a Default Property in Visual Basic

How to: Put a Value in a Property (Visual Basic)

How to: Get a Value from a Property (Visual Basic)

Reference

Property Statement

Get Statement

Set Statement (Visual Basic)

Concepts

Property Procedures (Visual Basic)

Procedure Parameters and Arguments (Visual Basic)

Differences Between Properties and Variables in Visual Basic