Server.GetActiveDBConnectionCount Method

Article
12/03/2008

Returns the number of active connections for the specified database.

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

Syntax

'Declaration
Public Function GetActiveDBConnectionCount ( _
    dbName As String _
) As Integer

public int GetActiveDBConnectionCount (
    string dbName
)

public:
int GetActiveDBConnectionCount (
    String^ dbName
)

public int GetActiveDBConnectionCount (
    String dbName
)

public function GetActiveDBConnectionCount (
    dbName : String
) : int

Parameters

dbName
A String value that specifies the name of the database.

Return Value

An Int32 value that specifies the number of active connections for the specified database.

Remarks

Updated text:

This method returns the number of active connections to a database. By iterating through all the databases on the instance of SQL Server, you can determine the total number of connections to databases on the instance of SQL Server.

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

Example

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

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

'Display the number active connections to the database.
Console.WriteLine(db.ActiveConnections)

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