Share via


Database.Rename Method

Renames the database.

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

Syntax

'Declaration
Public Sub Rename ( _
    newName As String _
)
public void Rename (
    string newName
)
public:
virtual void Rename (
    String^ newName
) sealed
public final void Rename (
    String newName
)
public final function Rename (
    newName : String
)

Parameters

  • newName
    A string value that specifies the new name of the database.

Remarks

Updated text:17 July 2006

Note:   An alternative to renaming the database is to create a synonym for the database.

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")

'Rename the database
db.Rename("AdventureWorks2")

'Refresh the properties on the database.
db.Refresh()
db.Rename("AdventureWorks")

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.

See Also

Reference

Database Class
Database Members
Microsoft.SqlServer.Management.Smo Namespace

Other Resources

How to: Create, Alter, and Remove a Database in Visual Basic .NET
Creating, Altering, and Removing Databases
ALTER DATABASE (Transact-SQL)

Change History

Release

History

17 July 2006

Changed content:
  • Added text to the Remarks section.

  • Added code to the Example section.