• Article

ReplaceDatabase Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The ReplaceDatabase property directs a restore operation when a new image of the restored database is required.

Syntax

object
.ReplaceDatabase [= value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list

  • value
    TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetReplaceDatabase(LPBOOL pRetVal);
HRESULT SetReplaceDatabase(BOOL NewValue);

Remarks

If TRUE, a new image of the database is created. The image is created regardless of the presence of an existing database with the same name.

If FALSE (default), a new image of the database is not created by the restore operation. The database targeted by the restore operation must exist on an instance of Microsoft SQL Server.

Applies To:

Restore Object