Server.AttachDatabase Method (String, StringCollection, String)

Artikel
12/15/2008

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

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

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

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

public void AttachDatabase (
    String name, 
    StringCollection files, 
    String owner
)

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

Parameter

name
A String value that specifies the name of the database to be attached.

files
A StringCollection object value that contains a list database files.

owner

Hinweise

Aktualisierter Text:

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.

Der Namespace, die Klasse oder das Element wird nur in der Version 2.0 von Microsoft .NET Framework unterstützt.

Beispiel

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
Dim owner As String
Dim logstr as String
Dim datastr as String
owner = srv.Databases("AdventureWorks").Owner

'Detach the AdventureWorks database.
srv.DetachDatabase("AdventureWorks", False, False)

'Display information about the detached database.
Dim d As DataTable
Datastr = "C:\Program Files\Microsoft SQL Server"
Datastr = datastr + "\MSSQL.1\MSSQL\Data\AdventureWorks_Data.mdf"
Logstr = "C:\Program Files\Microsoft SQL Server"
Logstr = datastr + "\MSSQL.1\MSSQL\Data\AdventureWorks_Log.ldf"
d = srv.DetachedDatabaseInfo(datastr)
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

'Check whether the file is a detached primary file.
Console.WriteLine(srv.IsDetachedPrimaryFile(datastr))

'Attach the database
Dim sc As StringCollection
sc = New StringCollection
sc.Add(datastr)
sc.Add(logstr)
srv.AttachDatabase("AdventureWorks", sc, owner, AttachOptions.None)

Threadsicherheit

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.

Plattformen

Entwicklungsplattformen

Eine Liste der unterstützten Plattformen finden Sie unterHardware- und Softwareanforderungen für die Installation von SQL Server 2005.

Zielplattforme

Eine Liste der unterstützten Plattformen finden Sie unterHardware- und Softwareanforderungen für die Installation von SQL Server 2005.

Siehe auch

Verweis

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

Andere Ressourcen

How to: Use an SMO Method with a Parameter in Visual Basic .NET
Calling Methods
Verwalten von Servern

Freigeben über