Syntax

object.Database [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

String that specifies a SQL Server database by name

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetDatabase(SQLDMO_LPBSTR pRetVal);

HRESULT SetDatabase(SQLDMO_LPCSTR NewValue);

Note  SQL-DMO strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.

Remarks

For a Login object, the Database property identifies the default database for the SQL Server login referenced.

For a Backup or Restore object, the Database property identifies the source or target database for a Transact-SQL BACKUP or RESTORE statement. The property is a required element and must be set prior to calling the SQLBackup method of the Backup object or the SQLRestore method of the Restore object.