LocalConnectionString 属性 (SQL Server Compact Edition)

  • 项目

提供本地 Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition) 数据库的连接字符串。

语法

object.LocalConnectionString

属性

组成部分 说明

Object

SQL Server Compact Edition Engine 对象

可修改

只读

备注

只有在连接关闭时，才能设置 LocalConnectionString 属性。许多连接字符串值都具有相应的只读属性。设置连接字符串后，所有这些属性都将更新，但检测到错误时除外。在这种情况下，不会更新任何属性。

对关闭的连接重置 LocalConnectionString 将重置所有连接字符串值和相关的属性（包括密码）。

下表列出了在 SQL Server Compact Edition 中支持的 LocalConnectionString 属性。

属性

说明

data source

SQL Server Compact Edition 数据库的文件路径和文件名。

注意：
应指定数据库文件的绝对路径，而不是相对路径。

ssce: database password

数据库密码，最多包含 40 个字符。如果未指定，默认值为没有密码。如果对数据库启用加密功能，此属性为必需的。如果指定密码，将对数据库启用加密功能。

ssce: encrypt database

指定数据库是否为加密数据库的布尔值。启用加密功能时，必须设置为 True；不使用加密功能时，必须设置为 False。如果未指定，默认值为 False。如果启用加密功能，必须也使用密码属性指定密码。如果指定密码，不管此属性如何设置，都将启用加密功能。

ssce: max buffer size

在开始将更改刷新到磁盘之前，SQL Server Compact Edition 可以使用的最大内存量 (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)。

下表列出了连接字符串的 mode 属性的有效值：

值

定义

读写

允许多个进程打开并修改数据库。这是未指定 mode 属性时的默认设置。

只读

允许打开数据库的只读副本。

独占

不允许其他进程打开或修改数据库。

共享读取

允许其他进程读取您打开的数据库，但不允许修改。

下列规则适用于连接字符串：

  1. 所有空白字符都将忽略，值或引号内的空白字符除外。

  2. 关键字值对之间必须用分号 (;) 分隔。如果分号是值的一部分，还必须用引号进行分隔。

  3. 不支持转义序列。

  4. 值类型是不相关的。

  5. 名称不区分大小写。

  6. 如果某属性名在连接字符串中多次出现，将使用与最后一个关联的值。

  7. 值可以使用单引号或双引号进行分隔，例如，name='value' 或 name="value"。在一个连接字符串中，既可以使用单引号也可以使用双引号，前提是将另一个用作分隔符。例如，在连接字符串中，下列引号用法是有效的：

    "data source='MyDb.sdf'; ssce: mode=Exclusive;"
'data source="MyDb.sdf"; ssce: mode=Exclusive;'
But these examples are not valid:
"data source="MyDb.sdf"; ssce: mode=Exclusive;"
'data source='MyDb.sdf'; ssce: mode=Exclusive;'

请参阅

参考

SSCEError 对象
CompactDatabase 方法 (SQL Server Compact Edition)
SSCEErrors 集合

帮助和信息

获取 SQL Server Compact Edition 帮助