RecalcSpaceUsage Method

SQL-DMO

SQL-DMO

RecalcSpaceUsage Method

The RecalcSpaceUsage method forces the update of data reporting the disk resource usage of the referenced Microsoft® SQL Server™ 2000 database or database object.

Applies To
Database Object Table Object
Index 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.