Question

The SqlDataReader class offers a method called GetValues. What I find curious about this method is that it takes an object[] as input and returns an int of the number of values copied into the array.

Any idea why the method was designed that way, rather than returning a new Array?

Answer 1

According to the documentation:

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

This allows the caller to be in complete control of the memory allocation and also control the number of columns requested easily.