FileGrowth Property

SQL-DMO

SQL-DMO

FileGrowth Property

The FileGrowth property specifies the growth increment of the operating system file used to store table, index, or log data.

Applies To
DBFile Object LogFile Object
Syntax

object.FileGrowth [= value]

Part

object

Expression that evaluates to an object in the Applies To list

value

Long integer

Data Type

Long

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetFileGrowth(LPLONG pRetVal);

HRESULT SetFileGrowth(LONG NewValue);

Remarks

The FileGrowth value is evaluated using the FileGrowthType property.

When FileGrowthType is SQLDMOGrowth_MB, the value represents the number of megabytes of disk space to allocate for incremental file growth.

When FileGrowthType is SQLDMOGrowth_Percent, the value represents a percentage and must be in the range from 1 through 100. At no time does Microsoft® SQL Server™ increment a file in units smaller than one megabyte, regardless of the result of the percentage of file size calculation.