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 参考

 

ULConnectionStringBuilder 类

生成用于打开 UltraLite 数据库连接的连接字符串。常用连接参数为 ULConnectionStringBuilder 对象上的各个属性。此类无法继承。

语法
Visual Basic
Public NotInheritable Class ULConnectionStringBuilder
  Inherits DbConnectionStringBuilder
C#
public sealed class ULConnectionStringBuilder: DbConnectionstring Builder
注释

Restrictions: 无法在 .NET Compact Framework 2.0 中使用 ULConnectionStringBuilder 类。

ULConnectionStringBuilder 对象用于指定打开连接 (ULConnection.Open) 或丢弃数据库 (ULDatabaseManager.DropDatabase) 时所需的参数。

前导和尾随空格在所有的值中均会被忽略。值不得包含前导或尾随空格,或是分号 (;),也不得以单引号 (') 或双引号 (") 开头。

构建连接字符串时,需要标识数据库并指定任何可选的连接设置。通过在 ULConnectionStringBuilder 对象上设置相应属性来提供所有连接参数后,即可使用 System.Data.Common.DbConnectionStringBuilder.ConnectionString 创建连接字符串。结果字符串被 ULConnection(String) 构造函数用来创建新的 ULConnection,或用来设置现有 ULConnection 对象的 ULConnection.ConnectionString。

Identifying the database

每个实例均包含特定于平台的指向数据库的路径。仅使用与执行平台对应的值。例如,在下面的代码中,将在 Windows Mobile 上使用 \UltraLite\mydb1.udb 路径,而在其它平台上则使用 mydb2.db。

' Visual Basic
Dim dbName As ULConnectionStringBuilder = _
  new ULConnectionStringBuilder
dbName.DatabaseOnCE = "\UltraLite\mydb1.udb"
dbName.DatabaseOnDesktop = "somedir\mydb2.udb"

// C#
ULConnectionStringBuilder dbName = new ULConnectionStringBuilder();
dbName.DatabaseOnCE = "\\UltraLite\\mydb1.udb";
dbName.DatabaseOnDesktop = @"somedir\mydb2.udb";

对于 UltraLite 数据库文件,建议使用扩展名 .udb。在 Windows Mobile 设备上,缺省数据库为 \UltraLiteDB\ulstore.udb。在其它 Windows 平台上,缺省数据库为 ulstore.udb。在 C# 中,必须对路径中的任何反斜线字符进行转义,或是在字符串文字两边加上 @。

如果使用多个数据库,则必须为每个数据库指定一个数据库名。有关详细信息,请参见DatabaseName 属性

Optional connection settings

视应用程序的需要和数据库的创建方式而定,可能需要提供非缺省的 ULConnectionStringBuilder.UserID 和 ULConnectionStringBuilder.Password、数据库 ULConnectionStringBuilder.DatabaseKey 以及连接 ULConnectionStringBuilder.CacheSize。如果应用程序使用多个连接,则应为每个连接提供唯一的 ULConnectionStringBuilder.ConnectionName。

数据库由一个已通过验证的用户 DBA 来创建,其初始口令为 sql。缺省情况下会使用用户 ID DBA 和口令 sql 打开连接。要禁用缺省用户,请使用 ULConnection.RevokeConnectFrom。要添加用户或更改用户口令,请使用 ULConnection.GrantConnectTo。

如果创建数据库时提供了加密密钥,那么随后与数据库的所有连接都必须使用同一个加密密钥。要更改数据库的加密密钥,请使用 ULConnection.ChangeEncryptionKey。

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

另请参见

ULConnectionStringBuilder 成员
ULConnectionStringBuilder 构造函数
CacheSize 属性
ConnectionName 属性
DatabaseKey 属性
DatabaseName 属性
DatabaseOnCE 属性
DatabaseOnDesktop 属性
Item 属性
OrderedTableScans 属性
Password 属性
ReserveSize 属性
StartLine 属性
UserID 属性
ContainsKey 方法
EquivalentTo 方法
GetShortName 方法
Remove 方法
TryGetValue 方法