LocalConnectionString 屬性 (RDA)
LocalConnectionString 屬性會為 Microsoft Windows CE 裝置上的 SQL Server Compact 3.5 資料庫指定 OLE DB 連接字串。
語法
object.LocalConnectionString(value)
適用於
SQL Server Compact 3.5 RDA 物件
資料類型
String
可修改
讀取/寫入
原型
HRESULT get_LocalConnectionString(BSTR *pVal);
HRESULT put_LocalConnectionString(BSTR newVal);
通用參數
參數 |
說明 |
|---|---|
value |
SQL Server Compact 3.5 資料庫的 OLE DB 連接字串。 |
備註
下表顯示 OLE DB 連接字串的可用屬性名稱。
屬性 |
說明 |
|---|---|
data source |
SQL Server Compact 3.5 資料庫的檔案路徑和名稱。請指定資料庫檔案的絕對路徑，而不是相對路徑。 .gif "附註") 附註
桌上型電腦上執行的應用程式無法在裝置上開啟與 .sdf 檔案的資料庫連接。同樣地，在裝置上執行的應用程式無法在桌上型電腦上開啟與 .sdf 檔案的資料庫連接。
|
ssce: database password |
資料庫密碼，最長 40 個字元。若未指定，則預設值為無密碼。如果您啟用資料庫加密，就需要這項屬性。如果您指定密碼，就會啟用資料庫的加密。如果提供了空白密碼，資料庫將不會加密。 |
ssce: encrypt database |
決定資料庫是否加密的 Boolean 值。若要啟用加密，必須設定為 true，或設定為 false 則不加密。如果未指定，則預設值為 false。如果啟用加密，您必須利用密碼屬性來指定密碼。如果您指定密碼，則無論此項屬性如何設定，都會啟用加密功能。如果已指定密碼，不論是否指定 SSCE:Encrypt Database，資料庫都會加密。 附註
encrypt 屬性將在未來的版本中被取代。此屬性保留在 SQL Server Compact 3.5 以顧全回溯相容性。
|
ssce:encryption mode 或 encryption mode |
這個屬性的值包括 engine default、 platform default 或 ppc2003 compatibility。預設值為 platform default。 |
ssce: max buffer size |
SQL Server Compact 3.5 開始將變更排清到磁碟之前，可以使用的最大記憶體數量，單位為 KB。若未指定，則預設值為 640。 |
ssce: max database size |
資料庫大小上限 MB。若未指定，則預設值為 128。 |
ssce:mode |
開啟資料庫檔案時使用的模式。如需有效值，請參閱下表。若未指定，則預設值為讀取/寫入。 |
ssce: default lock timeout |
交易等候鎖定的預設毫秒數。若未指定，則預設值為 2000。 |
ssce: default lock escalation |
在嘗試從資料列擴大到頁面，或是從頁面擴大到資料表之前，一個交易所需的鎖定數目。若未指定，則預設值為 100。 |
ssce: flush interval |
指定將所有確認的交易排清到磁碟上的間隔時間秒數。若未指定，則預設值為 10。 |
ssce: autoshrink threshold |
資料庫檔案內允許的可用空間百分比，若超過此百分比，就會開始自動壓縮。若其值為 100，就會停用自動壓縮。若未指定，則預設值為 60。 |
ssce: temp file directory |
暫存資料庫的位置。若未指定，則預設值是使用資料來源屬性中所指定的資料庫來暫時儲存。 |
ssce: temp file max size |
暫存資料庫檔案的大小上限，以 MB 為單位。若未指定，則預設值為 128。 |
locale identifier |
搭配資料庫使用的地區設定識別碼 (LCID)。 |
ssce:case sensitive |
判斷資料庫是否區分大小寫的布林值。必須設為 true 才能啟用區分大小寫，或設為 false 表示不區分大小寫。如果未指定，則預設值為 false。 附註
SQL Server Compact 3.5 SP1 中導入了這個連接屬性。
|
下表顯示連接字串之 mode 屬性的有效值。
值 |
定義 |
|---|---|
讀取/寫入 |
允許多重處理程序開啟及修改資料庫。若未指定模式屬性，就會使用此預設值。 |
唯讀 |
讓您開啟一份唯讀資料庫。 |
獨佔 |
不讓其他處理程序開啟或修改資料庫。 |
共用讀取 |
在您開啟資料庫時，讓其他處理程序讀取此資料庫，但是無法加以修改。 |
下列規則適用於連接字串：
忽略所有的空白字元，但是在值之內或引號之內的空白字元除外。
關鍵字值配對必須以分號 (;) 隔開。如果值中含有分號，則此分號也必須以引號分隔。
不支援任何逸出序列。
與值型別無關。
名稱不區分大小寫。
如果屬性名稱在連接字串中出現一次以上，就會使用最後出現的項目。
可利用單引號或雙引號分隔數值，例如 name='value' 或 name="value"。連接字串中可以使用單引號或雙引號，只要使用另一種引號做為分隔符號即可。例如，下列為引號在連接字串內的有效使用方式：
"data source='MyDb.sdf'; ssce: mode=Exclusive;" 'data source="MyDb.sdf"; ssce: mode=Exclusive;'- 但以下範例則是無效的使用方式：
"data source="MyDb.sdf"; ssce: mode=Exclusive;" 'data source='MyDb.sdf'; ssce: mode=Exclusive;'