ULConnectionStringBuilder 类

生成用于打开 UltraLite 数据库连接的连接字符串。

Visual Basic 语法

Public NotInheritable Class ULConnectionStringBuilder
    Inherits System.Data.Common.DbConnectionStringBuilder

C# 语法

public sealed class ULConnectionStringBuilder : 
    System.Data.Common.DbConnectionStringBuilder

成员

ULConnectionStringBuilder 类的所有成员，包括所有继承的成员。

名称	说明
ULConnectionStringBuilder 构造函数	用 ULConnectionStringBuilder 对象的缺省值初始化该对象。
Add 方法（从 System.Data.Common.DbConnectionStringBuilder 继承）	将具有指定键和值的条目添加到 DbConnectionStringBuilder 中。
AppendKeyValuePair 方法（从 System.Data.Common.DbConnectionStringBuilder 继承）	提供一种有效且安全的方法将键和值附加到现有 System.Text.StringBuilder 对象。
Clear 方法（从 System.Data.Common.DbConnectionStringBuilder 继承）	清除 System.Data.Common.DbConnectionStringBuilder 实例的内容。
ClearPropertyDescriptors 方法（从 System.Data.Common.DbConnectionStringBuilder 继承）	清除相关联的 System.Data.Common.DbConnectionStringBuilder 上的 System.ComponentModel.PropertyDescriptor 对象的集合。
ContainsKey 方法	确定 ULConnectionStringBuilder 对象是否包含特定关键字。
EquivalentTo 方法	将此 ULConnectionStringBuilder 对象中的连接信息与所提供 DbConnectionStringBuilder 对象中的连接信息进行比较。
GetProperties 方法（从 System.Data.Common.DbConnectionStringBuilder 继承）	使用与此 System.Data.Common.DbConnectionStringBuilder 的所有属性相关的信息填充所提供的 System.Collections.Hashtable。
GetShortName 方法	检索所提供关键字的简短版本。
Remove 方法	从 ULConnectionStringBuilder 对象中删除具有指定键的条目。
ShouldSerialize 方法（从 System.Data.Common.DbConnectionStringBuilder 继承）	指示指定键是否存在于此 System.Data.Common.DbConnectionStringBuilder 实例中。
ToString 方法（从 System.Data.Common.DbConnectionStringBuilder 继承）	返回与此 System.Data.Common.DbConnectionStringBuilder 相关联的连接字符串。
TryGetValue 方法	从此 ULConnectionStringBuilder 对象中检索与所提供的键对应的值。
BrowsableConnectionString 属性（从 System.Data.Common.DbConnectionStringBuilder 继承）	获取或设置一个值，指示 System.Data.Common.DbConnectionStringBuilder.ConnectionString 属性在 Visual Studio 设计器中是否可见。
CacheSize 属性	UL Ext：指定高速缓存的大小。
ConnectionName 属性	指定连接名称。
ConnectionString 属性（从 System.Data.Common.DbConnectionStringBuilder 继承）	获取或设置与此 System.Data.Common.DbConnectionStringBuilder 相关联的连接字符串。
Count 属性（从 System.Data.Common.DbConnectionStringBuilder 继承）	获取 System.Data.Common.DbConnectionStringBuilder.ConnectionString 中当前包含的键数。
DatabaseKey 属性	指定用于加密数据库的密钥。
DatabaseName 属性	指定数据库的名称，或需要与之建立连接的已装载数据库的名称。
DatabaseOnDesktop 属性	UL Ext：指定 UltraLite 数据库在 Windows 桌面平台中的路径和文件名。
DatabaseOnDevice 属性	UL Ext：指定 UltraLite 数据库在 Windows Mobile 上的路径和文件名。
IsFixedSize 属性（从 System.Data.Common.DbConnectionStringBuilder 继承）	获取一个值，该值表示 System.Data.Common.DbConnectionStringBuilder 是否具有固定大小。
IsReadOnly 属性（从 System.Data.Common.DbConnectionStringBuilder 继承）	获取一个值，该值表示 System.Data.Common.DbConnectionStringBuilder 是否为只读。
Keys 属性（从 System.Data.Common.DbConnectionStringBuilder 继承）	获取包含 System.Data.Common.DbConnectionStringBuilder 中的键的 System.Collections.ICollection。
OrderedTableScans 属性	指定不含 ORDER BY 子句的 SQL 查询是否应在缺省情况下执行有序的表扫描。
Password 属性	为经过验证的用户指定口令。
ReserveSize 属性	UL Ext：指定为存储 UltraLite 持久数据而预留的文件系统空间。
StartLine 属性	指定位置，然后启动 UltraLite 引擎。
this 属性	指定所指定连接关键字的值。
UserID 属性	为数据库指定一个经过验证的用户。
Values 属性（从 System.Data.Common.DbConnectionStringBuilder 继承）	获取包含 System.Data.Common.DbConnectionStringBuilder 中的值的 System.Collections.ICollection。

注释

常用连接参数为 ULConnectionStringBuilder 对象上的各个属性。

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

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

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

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

识别数据库

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

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

以下代码为 C# 语言等效代码：

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

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

如果使用多个数据库，则必须为每个数据库指定一个数据库名。

可选的连接设置

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

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

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

另请参见

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

使用DocCommentXchange讨论此页。