GetValues method

Returns all the column values for the current row.

Syntax

Visual Basic
Public Overrides Function GetValues( _
   ByVal values As Object() _
) As Integer

C#
public override int GetValues(
   object[] values
);

Parameters

values The array of System.Objects to hold the entire row.

Return value

The number of column values retrieved. If the length of the array is greater than the number of columns (ULDataReader.FieldCount), only FieldCount items are retrieved and the rest of the array is left unchanged.

Remarks

For most applications, the GetValues method provides an efficient means for retrieving all columns, rather than retrieving each column individually.

You can pass an System.Object array that contains fewer than the number of columns contained in the resulting row. Only the amount of data the System.Object array holds is copied to the array. You can also pass an System.Object array whose length is more than the number of columns contained in the resulting row.

This method returns DBNull for NULL database columns. For other columns, it returns the value of the column in its native format.