共用方式為

Server.DetachDatabase Method (String, Boolean, Boolean)

  • 發行項

Detaches the specified database from the instance of Microsoft SQL Server with the option to update statistics before the database is detached.

命名空間: Microsoft.SqlServer.Management.Smo
組件: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

語法

'宣告
Public Sub DetachDatabase ( _
    databaseName As String, _
    updateStatistics As Boolean, _
    removeFulltextIndexFile As Boolean _
)

public void DetachDatabase (
    string databaseName,
    bool updateStatistics,
    bool removeFulltextIndexFile
)

public:
void DetachDatabase (
    String^ databaseName, 
    bool updateStatistics, 
    bool removeFulltextIndexFile
)

public void DetachDatabase (
    String databaseName, 
    boolean updateStatistics, 
    boolean removeFulltextIndexFile
)

public function DetachDatabase (
    databaseName : String, 
    updateStatistics : boolean, 
    removeFulltextIndexFile : boolean
)

參數

  • databaseName
    A String value that specifies the name of the database to be detached.

  • updateStatistics
    A Boolean value that specifies whether to update the statistics for the database before detaching it.

    If True, statistics are updated.

    If False, statistics are not updated.

  • removeFulltextIndexFile
    A Boolean value that specifies whether to remove a full-text index file before detaching the database.

    If True, the full-text index file is removed.

    If False, the full-text index file is not removed.

備註

更新的文字：

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.

只有 Microsoft .NET Framework 2.0 版支援此命名空間、類別或成員。

範例

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

執行緒安全性

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.

平台

開發平台

如需受支援的平台清單，請參閱＜安裝 SQL Server 2005 的硬體和軟體需求＞。

目標平台

如需受支援的平台清單，請參閱＜安裝 SQL Server 2005 的硬體和軟體需求＞。

請參閱

參考

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

其他資源

How to: Use an SMO Method with a Parameter in Visual Basic .NET
卸離和附加資料庫
Calling Methods
管理伺服器
卸離資料庫 (一般頁面)