Database.EnumLocks Method ()

Article
12/03/2008

Enumerates a list of all current locks held on the database.

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

Syntax

'Declaration
Public Function EnumLocks As DataTable

public DataTable EnumLocks ()

public:
DataTable^ EnumLocks ()

public DataTable EnumLocks ()

public function EnumLocks () : DataTable

Return Value

A DataTable object value that contains a list of locks held on the database and information about the type and location of the locks. The table describes the different columns of the returned DataTable.

Column	Data type	Description
RequestorSpid	Int32	The system process ID value of the process that is holding a lock on a database resource.
LockType	String	The description of the type of lock. See the syslockinfo table for a description of different lock types.
Database	String	The name of the database on which the lock is held.
Table	String	The name of the table on which the lock is held. This field contains a value only if the lock is held on a table.
Index	String	The name of the index on which the lock is held. This field contains a value only if the lock is held on an index.
Status	Int32	The status of the lock, which can be one of the following: 1 = Granted. 2 = Converting. 3 = Waiting.

Remarks

Updated text:17 July 2006

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

Example

The example runs a Server object enumeration method, but extracting the information from the DataTable object is the same for Database enumeration methods.

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Call the EnumCollations method and return collation information to DataTable variable.
Dim d As DataTable
'Select the returned data into an array of DataRow.
d = srv.EnumCollations
'Iterate through the rows and display collation details for the instance of SQL Server.
Dim r As DataRow
Dim c As DataColumn
For Each r In d.Rows
    Console.WriteLine("============================================")
    For Each c In r.Table.Columns
        Console.WriteLine(c.ColumnName + " = " + r(c).ToString)
    Next
Next

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.

Change History

Release	History
17 July 2006	Changed content: Added code to the Example section.