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
)
参数
- value
类型:System.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");