Share via

  • Article

Server.AttachDatabase Method (String, StringCollection, String, AttachOptions)

Attaches an existing database that is made up of one or more files to the instance of SQL Server by using the specified name, data files, and attachment options. 

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

Syntax

'Declaration
Public Sub AttachDatabase ( _
    name As String, _
    files As StringCollection, _
    owner As String, _
    attachOptions As AttachOptions _
)
'Usage
Dim instance As Server
Dim name As String
Dim files As StringCollection
Dim owner As String
Dim attachOptions As AttachOptions

instance.AttachDatabase(name, files, owner, _
    attachOptions)

public void AttachDatabase(
    string name,
    StringCollection files,
    string owner,
    AttachOptions attachOptions
)

public:
void AttachDatabase(
    String^ name, 
    StringCollection^ files, 
    String^ owner, 
    AttachOptions attachOptions
)

member AttachDatabase : 
        name:string * 
        files:StringCollection * 
        owner:string * 
        attachOptions:AttachOptions -> unit 

public function AttachDatabase(
    name : String, 
    files : StringCollection, 
    owner : String, 
    attachOptions : AttachOptions
)

Parameters

  • name
    Type: System.String
    A String value that specifies the name of the database to be attached.

Remarks

The data and transaction log files of a database can be detached and then reattached to the same or another instance of SQL Server. Detaching and attaching a database is useful if you want to change the database to a different instance of SQL Server on the same computer, or if you want to move the database.

Use this overload to specify the owner of the database after it is attached.