共用方式為

SqlCeConnection.ChangeDatabase Method

  • 發行項

為開啟的 SqlCeConnection 變更目前的資料庫。

命名空間: System.Data.SqlServerCe
組件: System.Data.SqlServerCe (在 system.data.sqlserverce.dll)

語法

'宣告
Public Overrides Sub ChangeDatabase ( _
    value As String _
)

public override void ChangeDatabase (
    string value
)

public:
virtual void ChangeDatabase (
    String^ value
) override

public void ChangeDatabase (
    String value
)

public override function ChangeDatabase (
    value : String
)

參數

  • value
    資料庫名稱。

傳回值

如果資料庫變更成功則為 true，否則為 false。

例外狀況

例外狀況型別 條件
ArgumentException

資料庫名稱無效。
InvalidOperationException

連接尚未開啟。
SqlCeException

無法變更資料庫。

備註

value 參數中所提供的名稱必須是有效的資料庫名稱。該名稱必須是資料庫的完整路徑；例如，「\my app\myDB.sdf」。value 參數不可為 null、空白，或只包含空白字元的字串。

ChangeDatabase 會將用來開啟目前資料庫的相同屬性套用到新的資料庫上，但密碼除外，它會將密碼設定為空字串。

如果新資料庫需要密碼，這個呼叫就會失敗。如果發生這種狀況，您必須關閉原來的連接、指定新的連接字串，然後再重新開啟連接，才能變更資料庫。

範例

下列範例顯示如何在保留原始連接選項的同時切換資料庫。

Dim conn As New SqlCeConnection()

' Set some connection string properties e.g.:
' 
conn.ConnectionString = _
    "Persist Security Info = False; Data Source = 'SalesData.sdf';" & _
    "Password = '<password>'; File Mode = 'shared read'; " & _
    "Max Database Size = 256; Max Buffer Size = 1024"

conn.Open()

' You can change the database while preserving 
' the orignal connection options
'
conn.ChangeDatabase("SupportData.sdf")

SqlCeConnection conn = new SqlCeConnection();

// Set some connection string properties e.g.:
// 
conn.ConnectionString = 
    "Persist Security Info = False; Data Source = 'SalesData.sdf';" +
    "Password = '<password>'; File Mode = 'shared read'; " +
    "Max Database Size = 256; Max Buffer Size = 1024";

conn.Open();

// You can change the database while preserving 
// the orignal connection options
//
conn.ChangeDatabase("SupportData.sdf");

執行緒安全性

任何公用靜態 (共用 在 Microsoft Visual Basic) 此型別的成員具備執行緒安全。不保證任何執行個體成員安全執行緒。

平台

開發平台

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
版本資訊
.NET Framework 及 NET Compact Framework
支援於 3.5
.NET Framework
支援於 3.0
.NET Compact Framework 及 .Net Framework
支援於 2.0

另請參閱

參考

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace