InstanceDatabaseFile.GrowthIncrement Property
Gets or sets the increment by which the data file size will increase when additional space is needed.
Namespace: Microsoft.SqlServer.Management.Nmo
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)
Syntax
'Declaration
Public Property GrowthIncrement As String
public string GrowthIncrement { get; set; }
public:
property String^ GrowthIncrement {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_GrowthIncrement ()
/** @property */
public void set_GrowthIncrement (String value)
public function get GrowthIncrement () : String
public function set GrowthIncrement (value : String)
Property Value
A String, up to 16 characters in length, containing the file growth increment.
Remarks
This property must be either the increment size or a percentage. If you specify an increment size, the value must be a nonnegative integer, with an optional suffix to indicate the unit of measure: kilobyte (KB), megabyte (MB), gigabyte (GB), or terabyte (TB). If the suffix is not specified, the default unit of measure is megabytes (MB). If you specify a percentage, the growth increment size is the specified percentage of the database size at the time the increment occurs. To specify a percentage, use the percent (%) sign.
For more information, see the growth_increment parameter in the CREATE DATABASE (Transact-SQL) topic.
Example
The following examples show how to define a data file for the instance database:
InstanceDatabaseFileGroup idb_fg =
new InstanceDatabaseFileGroup(idb, "PRIMARY");
idb.InstanceDatabaseFileGroups.Add(idb_fg);
// Define and add a data file
InstanceDatabaseFile idb_file1 =
new InstanceDatabaseFile(idb_fg, "MyInst_PrimaryFile1");
idb_file1.FileName = @"C:\NS\Full\MyInst_PrimaryFile1.mdf";
idb_file1.InitialSize = "5MB";
idb_file1.MaxSize = "15MB";
idb_file1.GrowthIncrement = "10%";
idb_fg.InstanceDatabaseFiles.Add(idb_file1);
' Define and add a filegroup
Dim idb_fg As InstanceDatabaseFileGroup = _
New InstanceDatabaseFileGroup(idb, "PRIMARY")
idb.InstanceDatabaseFileGroups.Add(idb_fg)
' Define and add a data file
Dim idb_file1 As InstanceDatabaseFile = _
New InstanceDatabaseFile(idb_fg, "MyInst_PrimaryFile1")
idb_file1.FileName = "C:\NS\Full\MyInst_PrimaryFile1.mdf"
idb_file1.InitialSize = "5MB"
idb_file1.MaxSize = "15MB"
idb_file1.GrowthIncrement = "10%"
idb_fg.InstanceDatabaseFiles.Add(idb_file1)
Thread Safety
Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Platforms
Development Platforms
For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.
Target Platforms
For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.
See Also
Reference
InstanceDatabaseFile Class
InstanceDatabaseFile Members
Microsoft.SqlServer.Management.Nmo Namespace
Other Resources
Defining the Instance Database
GrowthIncrement Element for FileSpec (ICF)