DeleteRows Method (XArrayDB)

This method deletes count rows from an XArrayDB object starting at row index and returns the number of rows successfully deleted.

Syntax

XArrayDB.DeleteRows (index, [count])

Arguments

index is a long integer specifying the index of the first row to be deleted.

count is an optional long integer specifying the number of rows to be deleted. If omitted, this argument defaults to 1.

Return Value

A long integer specifying the number of rows successfully deleted.

Example

The following example initializes an XArrayDB object with 10 rows and 6 columns, then removes the first three rows:

MyArray.ReDim 1, 10, 1, 6

Dim i, j As Integer

For i = 1 To 10

For j = 1 To 6

MyArray(i, j) = "Row " & i & ", Col " & j

Next j

Next i

' Prints Row 1, Col 1.

Debug.Print MyArray(1, 1)

' Prints Row 2, Col 1.

Debug.Print MyArray(2, 1)

' Prints Row 8, Col 1.

Debug.Print MyArray(8, 1)

' Remove three rows starting at index 1.

Dim result As Long

result = MyArray.DeleteRows(1, 3)

' Prints 3.

Debug.Print result

' Prints 7.

Debug.Print MyArray.Count(1)

' Prints Row 4, Col 1.

Debug.Print MyArray(1, 1)

' Prints Row 5, Col 1.

Debug.Print MyArray(2, 1)

' The next line now gives a "Subscript out of range" error.

Debug.Print MyArray(8, 1)