Database.SpaceAvailable Property

Gets the available space in the database in KB.

Namespace:  Microsoft.SqlServer.Management.Smo
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Syntax

'Declaration
<SfcPropertyAttribute(SfcPropertyFlags.None Or SfcPropertyFlags.Expensive Or SfcPropertyFlags.Standalone)> _
Public ReadOnly Property SpaceAvailable As Double 
    Get
'Usage
Dim instance As Database 
Dim value As Double 

value = instance.SpaceAvailable
[SfcPropertyAttribute(SfcPropertyFlags.None|SfcPropertyFlags.Expensive|SfcPropertyFlags.Standalone)]
public double SpaceAvailable { get; }
[SfcPropertyAttribute(SfcPropertyFlags::None|SfcPropertyFlags::Expensive|SfcPropertyFlags::Standalone)]
public:
property double SpaceAvailable {
    double get ();
}
[<SfcPropertyAttribute(SfcPropertyFlags.None|SfcPropertyFlags.Expensive|SfcPropertyFlags.Standalone)>]
member SpaceAvailable : float
function get SpaceAvailable () : double

Property Value

Type: System.Double
A Float64 value that specifies the amount of available space in the database in KB.

Remarks

The size is specified in KB and should be the same as when the database was originally created unless you have opted to automatically grow or shrink the database. The space allocated in the database can be determined by using the SpaceAvailable property.

Examples

VB

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server

'Reference the AdventureWorks2012 database.
Dim db As Database
db = srv.Databases("AdventureWorks2012")

'Display size and space information for the database.
Console.WriteLine("data space usage (KB): " + _
db.DataSpaceUsage.ToString)
Console.WriteLine("index space usage (KB): " + _
db.IndexSpaceUsage.ToString)
Console.WriteLine("space available (KB): " + _
db.SpaceAvailable.ToString)
Console.WriteLine("database size (MB): " + _
db.Size.ToString)

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("AdventureWorks2012")

Write-Host "data space usage (KB):" $db.DataSpaceUsage
Write-Host "index space usage (KB):" $db.IndexSpaceUsage
Write-Host "space available (KB):" $db.SpaceAvailable
Write-Host "database size (MB):" $db.Size

See Also

Reference

Database Class

Microsoft.SqlServer.Management.Smo Namespace

Other Resources

Working with Database Objects

Creating, Altering, and Removing Databases

CREATE DATABASE (Transact-SQL)