Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » UltraLite - .NET 编程 » UltraLite .NET 2.0 API 参考 » ULConnectionParms 类

 

AdditionalParms 属性

采用以分号分隔的 "名称=值" 对的列表形式指定附加参数。这是一些较不常用的参数。

语法
Visual Basic
Public Property AdditionalParms As String
C#
public string  AdditionalParms { get; set; }
属性值

以分号分隔的 "关键字=值" 列表形式的附加参数。"关键字=值" 列表的值必须符合 ULConnection.ConnectionString 的规则。缺省值为空值引用(在 Visual Basic 中为 Nothing)。

注释

页面大小及保留大小参数值是以字节为单位指定的。使用后缀 k 或 K 来表示以千字节为单位;使用后缀 m 或 M 来表示以兆字节为单位。

附加参数有:

关键字

说明

dbn

标识需要与之建立连接的已装载数据库。

启动数据库时会为它指派一个数据库名,既可使用 dbn 参数显式指派,也可由 UltraLite 使用不带扩展名和路径的基本文件名进行指派。

打开连接时,UltraLite 会首先搜索具有匹配 dbn 且正在运行的数据库。如果未找到,则 UltraLite 会使用适当的数据库文件名参数(DatabaseOnCE 或 DatabaseOnDesktop)启动新的数据库。

如果应用程序(或 UltraLite 引擎)需要访问两个具有相同基本文件名的不同数据库,则必须使用此参数。

仅当使用 ULConnection.Open 打开连接时才会使用此参数。

ordered_table_scans

指定不含 ORDER BY 子句的 SQL 查询是否应在缺省情况下执行有序的表扫描。

自版本 10.0.1 起,当在 UltraLite 中使用动态 SQL 时,如果顺序对于执行查询并不重要,则 UltraLite 将会从数据库页直接访问行,而不是使用主键索引。这样会提高读取行的性能。要使用此优化,查询必须为只读且必须扫描所有的行。

当要求行以特定顺序排序时,应包括 ORDER BY 语句作为 SQL 查询的一部分。但一些应用程序会依赖于缺省情况下按主键顺序返回行的行为。在这种情况下,用户应将 ordered_table_scans 参数设置为 1(true、yes、on),以便在对表进行迭代时恢复为原来的行为。

当 ordered_table_scans 设置为 1(true、yes、on)且用户未指定 ORDER BY 子句时,或者,如果查询不会从索引中受益,则缺省情况下 UltraLite 将会使用主键。

以下参数字符串用于确保 UltraLite 采取与先前版本同样的行为。

createParms.AdditionalParms = "ordered_table_scans=yes"

缺省值为 0(false、off、no)。

仅当使用 ULConnection.Open 打开连接时才会使用此参数。

有关详细信息,请参见UltraLite 连接参数

reserve_size

预留文件系统空间以供存储 UltraLite 持久数据。

reserve_size 参数使您不用插入任何数据就能预先分配 UltraLite 数据库所需的文件系统空间。预留文件系统空间可以略微提高性能,还可以防止发生内存不足的故障。缺省情况下,持久存储文件仅会在需要时随着应用程序更新数据库而增长。

请注意,reserve_size 会预留文件系统空间,这包括持久存储文件中的元数据,而不仅仅是原始数据。当根据数据库的数据量得出所需的文件系统空间时,必须考虑元数据开销和数据压缩。建议运行含有测试数据的数据库,并注意观察持久存储文件的大小。

reserve_size 参数预留空间的方法是:在启动时将持久存储文件增大到给定的预留大小,而不管该文件先前是否存在。决不会将文件截断。

以下参数字符串用于确保在启动时持久存储文件的大小至少为 2 MB。

createParms.AdditionalParms = "reserve_size=2m"

仅当使用 ULConnection.Open 打开连接时才会使用此参数。

start

指定位置,然后启动 UltraLite 引擎。

仅当要连接到当前未在运行的引擎时,才提供 StartLine (START) 连接参数。

仅当 UltraLite 引擎不在系统路径中时,位置才是必需的。

有关配合使用 UltraLite.NET 和 UltraLite 引擎的详细信息,请参见RuntimeType 属性

另请参见