共用方式為

SqlCeConnection.ChangeDatabase 方法

  • 發行項

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

命名空間：  System.Data.SqlServerCe
組件：  System.Data.SqlServerCe (在 System.Data.SqlServerCe.dll 中)

語法

'宣告
Public Overrides Sub ChangeDatabase ( _
    value As String _
)
'用途
Dim instance As SqlCeConnection
Dim value As String

instance.ChangeDatabase(value)

public override void ChangeDatabase(
    string value
)

public:
virtual void ChangeDatabase(
    String^ value
) override

abstract ChangeDatabase : 
        value:string -> unit 
override ChangeDatabase : 
        value:string -> unit 

public override function ChangeDatabase(
    value : String
)

參數

實作

IDbConnection.ChangeDatabase(String)

例外狀況

例外狀況 條件
ArgumentException

資料庫名稱無效。
InvalidOperationException

連接尚未開啟。
SqlCeException

無法變更資料庫。

備註

value 參數中所提供的名稱必須是有效的資料庫名稱。該名稱必須是資料庫的完整路徑，例如 "\my app\myDB.sdf"。value 參數不可為 nullnull 參考 (在 Visual Basic 中為 Nothing)、空白，或只包含空白字元的字串。

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

請參閱

參考

SqlCeConnection 類別

System.Data.SqlServerCe 命名空間