How to: Create an Array

Article
11/16/2012

An array is an object, so you create it with a New (Visual Basic) clause and assign it to the array variable. You can do this as part of the array declaration, or in a subsequent assignment statement.

To create an array in the array declaration statement

In your declaration, add a New clause after the variable name and its parentheses. The following example declares a variable to hold an array with elements of the Date Data Type (Visual Basic), creates the array, and assigns it to the variable.
```
Dim validDates() As Date = New Date() {}
```
Following the execution of this statement, the array in variable validDates has length 0.

Note

The New clause must specify the type name, followed by parentheses, followed by braces, {}. The parentheses do not represent a call to an array constructor. Instead, they indicate that the object type is an array type. The braces supply initialization values. The compiler requires the braces even if you are not supplying any values. Therefore, the New clause must include both the parentheses and the braces, even if they are empty.

To create an array in a separate assignment statement

Use a subsequent assignment statement with a New clause. The following example declares a variable to hold an array with elements of the Integer Data Type (Visual Basic), and it creates the array and assigns it to the variable in another statement.
```
Dim scores() As Integer
scores = New Integer() {}
```
Following the execution of these statements, the array in variable scores has length 0.

-or-
Use the ReDim Statement (Visual Basic) to not only create an array but initialize its length.
```
ReDim scores(4)
```
Following the execution of this statement, the array in variable scores has length 5, with all the elements holding default values.

How to: Create an Array

To create an array in the array declaration statement

To create an array in a separate assignment statement

See Also

Tasks

Concepts

Other Resources

Additional resources