Share via


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 命名空间