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 帮助