UL Ext: 生成用于打开与 UltraLite 数据库连接的连接字符串。
Public Class ULConnectionParms Inherits System.ComponentModel.Component
public class ULConnectionParms : System.ComponentModel.Component
ULConnectionParms 类的所有成员,包括所有继承的成员。
名称 | 说明 |
---|---|
用 ULConnectionParms 实例的缺省值初始化该实例。 | |
|
释放 ![]() |
|
在垃圾回收功能回收 ![]() |
|
返回一个对象,该对象表示 ![]() ![]() |
返回此实例的字符串表示形式。 | |
采用以分号分隔的 "名称=值" 对的列表形式指定附加参数。 | |
指定高速缓存的大小。 | |
|
获取一个值,该值表示组件是否能够引发事件。 |
指定连接名称。 | |
|
获取包含 ![]() ![]() |
指定 UltraLite 数据库在 Windows 桌面平台上的路径和文件名。 | |
指定 UltraLite 数据库在 Windows Mobile 上的路径和文件名。 | |
|
获取一个值,该值表示 ![]() |
指定用于加密数据库的密钥。 | |
|
通过调用 ![]() |
为经过验证的用户指定口令。 | |
|
获取或设置 ![]() ![]() |
为数据库指定一个经过验证的用户。 |
常用连接参数为 ULConnectionParms 对象上的各个属性。
ULConnectionParms 对象用于指定打开连接 (ULConnection.Open) 或丢弃数据库 (ULDatabaseManager.DropDatabase) 时所需的参数。
前导和尾随空格在所有的值中均会被忽略。值不得包含前导或尾随空格,或是分号,也不得以单引号或双引号开头。
构建连接字符串时,需要标识数据库并指定任何可选的连接设置。通过在 ULConnectionParms 对象上设置相应属性来提供所有连接参数后,即可使用 ULConnectionParms.ToString 创建连接字符串。结果字符串被 ULConnection(String) 构造函数用来创建新的 ULConnection,或用来设置现有 ULConnection 对象的 ULConnection.ConnectionString。
Identifying the database
每个实例均包含特定于平台的指向数据库的路径。仅使用与执行平台对应的值。例如,在下面的代码中,将在 Windows Mobile 上使用 \UltraLite\mydb1.udb 路径,而在其它平台上则使用 mydb2.db。
' Visual Basic Dim dbName As ULConnectionParms = new ULConnectionParms dbName.DatabaseOnDevice = "\UltraLite\mydb1.udb" dbName.DatabaseOnDesktop = "somedir\mydb2.udb" |
以下代码为 C# 语言等效代码:
// C# ULConnectionParms dbName = new ULConnectionParms(); dbName.DatabaseOnDevice = "\\UltraLite\\mydb1.udb"; dbName.DatabaseOnDesktop = "somedir\mydb2.udb"; |
对于 UltraLite 数据库文件,建议使用扩展名 .udb。在 Windows Mobile 设备上,缺省数据库为 \UltraLiteDB\ulstore.udb。在其它 Windows 平台上,缺省数据库为 ulstore.udb。在 C# 中,必须对路径中的任何反斜线字符进行转义,或是在字符串文字两边加上 @。
如果使用多个数据库,则必须为每个数据库指定一个数据库名。
Optional connection settings
视应用程序的需要和数据库的创建方式而定,可能需要提供非缺省的 ULConnectionParms.UserID 和 ULConnectionParms.Password、数据库 ULConnectionParms.EncryptionKey 以及连接 ULConnectionParms.CacheSize。如果应用程序使用多个连接,则应为每个连接提供唯一的 ULConnectionParms.ConnectionName。
数据库由一个已通过验证的用户 DBA 来创建,其初始口令为 sql。缺省情况下会使用用户 ID DBA 和口令 sql 打开连接。要禁用缺省用户,请使用 ULConnection.RevokeConnectFrom。要添加用户或更改用户口令,请使用 ULConnection.GrantConnectTo。
如果创建数据库时提供了加密密钥,那么随后与数据库的所有连接都必须使用同一个加密密钥。要更改数据库的加密密钥,请使用 ULConnection.ChangeEncryptionKey。
有关详细信息,请参见UltraLite 连接参数。
ULConnectionParms 构造函数
ToString 方法
AdditionalParms 属性
CacheSize 属性
ConnectionName 属性
DatabaseOnDesktop 属性
DatabaseOnDevice 属性
EncryptionKey 属性
Password 属性
UserID 属性
![]() |
使用DocCommentXchange 讨论此页。
|
版权 © 2010, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.0 |