RecalcSpaceUsage Method

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 RecalcSpaceUsage method forces the update of data reporting the disk resource usage of the referenced Microsoft SQL Server database or database object.

Syntax

object.RecalcSpaceUsage()

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

Prototype (C/C++)

HRESULT RecalcSpaceUsage();

Remarks

Data reporting table and index size is maintained in values enumerating the number of pages allocated to store an index or table, the number of pages actually storing data, and the number of pages reserved for future storage.

Use the RecalcSpaceUsage method of the Database object to update usage data for all tables and indexes defined within a database. Use the RecalcSpaceUsage method of the Table or Index object to update data for the table or index referenced.

Note

For a large index, table or database, the RecalcSpaceUsage method can take some time to complete. It is suggested that you inform the user by using a warning message or busy pointer.