通过

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

public void ChangeDatabase (
    String value
)

public override function ChangeDatabase (
    value : String
)

不适用。

参数

  • value
    数据库名称。

返回值

如果数据库更改成功，则为 True；否则为 false。

异常

异常类型 条件

ArgumentException

数据库名称无效。

InvalidOperationException

连接未打开。

SqlCeException

该数据库不能更改。

备注

value 参数中提供的名称必须为有效的数据库名称。此名称必须为数据库的完整路径；例如，“\my app\myDB.sdf”。value 参数不能为 空引用（在 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");

平台

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Windows Vista、Microsoft Windows XP SP2 和 Windows Server 2003 SP1 支持 Microsoft .NET Framework 3.0。

版本信息

.NET Framework

受以下版本支持：3.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

SqlCeConnection 类
SqlCeConnection 成员
System.Data.SqlServerCe 命名空间