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 属性。
识别数据库
每个实例均包含特定于平台的指向数据库的路径。仅使用与执行平台对应的值。例如,在下面的代码中,将在 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# 中,必须对路径中的任何反斜线字符进行转义,或是在字符串文字两边加上 @。
如果使用多个数据库,则必须为每个数据库指定一个数据库名。
可选的连接设置
根据应用程序的需要和数据库的创建方式,可能需要提供非缺省的 ULConnectionParms.UserID 和 ULConnectionParms.Password 值、数据库 ULConnectionParms.EncryptionKey 值以及 ULConnectionParms.CacheSize 值。如果应用程序使用多个连接,则应为每个连接提供唯一的 ULConnectionParms.ConnectionName 值。
数据库由一个已通过验证的用户 DBA 来创建,其初始口令为 sql。缺省情况下会使用用户 ID DBA 和口令 sql 打开连接。要禁用缺省用户,请使用 ULConnection.RevokeConnectFrom 方法。要添加用户或更改用户口令,请使用 ULConnection.GrantConnectTo 方法。
如果创建数据库时提供了加密密钥,那么随后与数据库的所有连接都必须使用同一个加密密钥。要更改数据库的加密密钥,请使用 ULConnection.ChangeEncryptionKey 方法。
ULConnectionParms 构造函数
ToString 方法
AdditionalParms 属性
CacheSize 属性
ConnectionName 属性
DatabaseOnDesktop 属性
DatabaseOnDevice 属性
EncryptionKey 属性
Password 属性
UserID 属性
![]() |
使用DocCommentXchange讨论此页。
|
版权 © 2012, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.1 |