ResultSets Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The ResultSets property returns the count of units of data returned from query execution.

Syntax

object.ResultSets

Parts

  • object
    An expression that evaluates to an object in the Applies To list

Data Type

Long

Modifiable

Read-only

Prototype (C/C++)

HRESULT GetResultSets(LPLONG pRetVal);

Remarks

Commonly, Microsoft SQL Server query execution returns data to the client. Returned data may be an indicator of rows affected by the query, or it can be row data extracted from one or more SQL Server tables. When row data is returned, data is tabular and values in the resulting data can be referenced using ordinal column and row values.

The execution output of some SQL Server queries cannot be represented in a single result unit. For example, each statement in a batch of Transact-SQL statements may return a count of affected rows or row data. Some Transact-SQL statements return multiple units of data, for example, a SELECT statement containing a COMPUTE or COMPUTE BY clause. Each discrete unit of returned data is called a result set.

Use the ResultSets property to determine the number of units of returned data. Use the CurrentResultSet property to navigate between units.

Note

There is no guarantee of consistency between result sets. Each result set may have zero or more columns. Within each set, the names, data types, and meanings of the columns may vary.

Applies To: