ISSCEEngine.Upgrade 方法将 SQL Server Compact 数据库从版本 3.5 升级到 4.0。如果已对源数据库进行加密，则也会对升级后的数据库进行加密。除非在目标字符串中显式提供了密码，否则，不会对升级后的数据库进行加密。
语法
object.UpgradeDatabase(SourceConnection, DestConnection)
参数
参数 |
说明 |
|---|---|
SourceConnection |
一个字符串值，指定与源数据库（要升级的数据库）的连接。如果 SourceConnection 指定的数据库已经打开，将出现错误。 |
DestConnection（可选） |
一个字符串值，指定与目标数据库的连接（如果存在使用相同名称的其他文件）。 如果传递的 DestConnection 为 Null，则会从源文件派生必要属性，如 LCID 和 Password。 |
返回值
返回类型为 HRESULT，成功后将返回 S_OK。
原型
HRESULT UpgradeDatabase(BSTR SourceConnection, BSTR DestConnection);
若要将数据库文件从 SQL Server Compact 版本 3.1 升级到 3.5，且不创建新的文件，请在源连接字符串和目标连接字符串中传递相同的数据源属性。
注释
SourceConnection 和 DestConnection 参数指定源数据库和目标数据库的属性。下表列出了可以为每个参数指定的连接属性。所有其他连接属性都将被忽略。
属性 |
说明 |
|---|---|
Data Source |
指示数据库的名称。源连接信息和目标连接信息都需要使用此属性。 |
Locale Identifier |
指示新数据库的区域设置标识符 (LCID)。如果省略此属性，目标数据库将具有与系统区域设置相同的 LCID。 LCID 指定数据库中字符串比较的排序顺序。 |
SSCE:Database Password |
在数据库受密码保护时，指示密码。如果源数据库包含密码，则必须提供源数据库密码。如果在 DestConnection 字符串中省略此参数，新数据库将与源数据库具有相同的数据库密码。若要从目标数据库中删除密码，数据库密码必须设置为空字符串。数据库密码最大长度为 40 个字符。 |
SSCE:Temp File Directory |
指定临时数据库的位置。如果在 DestConnection 字符串中省略此参数，当前数据库的位置将用作临时数据库的位置。 |
SSCE:Encryption Mode |
指定默认加密模式。如果未指定，则使用 Platform Default。 |
SSCE:Case Sensitive |
指定数据库是否区分大小写。必须设置为 true 以启用区分大小写，或者设置为 false 以便不区分大小写。如果未指定，则默认值为 false。 .gif "注意") 注意
在 SQL Server Compact SP1 中引入了此连接属性。
|
若要查找唯一 LCID 值的列表，请参阅支持的排序规则 (SQL Server Compact)。必须确保在创建数据库的应用程序上支持该区域设置。
有关其他有效加密模式的列表，请参阅从早期版本进行升级 (SQL Server Compact)。