ISSCEEngine.UpgradeDatabase (SQL Server Compact)

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。 附註 SQL Server Compact SP1 中導入了這個連接屬性。

如需唯一 LCID 值的清單，請參閱＜支援的定序 (SQL Server Compact)＞。請確定要建立資料庫的應用程式可支援該地區設定。

如需不同有效加密模式的清單，請參閱＜從舊版升級 (SQL Server Compact)＞。