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 |
用于数据库的区域设置 ID (LCID)。 |
ssce:case sensitive |
一个用于确定数据库是否区分大小写的布尔值。必须设置为 true 以启用区分大小写，或者设置为 false 以便不区分大小写。如果未指定，则默认值为 false。 注意
在 SQL Server Compact 3.5 SP1 中引入了此连接属性。
|
下表显示了连接字符串的 mode 属性的有效值。
值 |
定义 |
|---|---|
读写 |
允许多个进程打开并修改数据库。这是未指定 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;'