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 类

UL Ext.: 生成用于打开与 UltraLite 数据库连接的连接字符串。常用连接参数为 ULConnectionParms 对象上的各个属性。

语法
Visual Basic
Public Class ULConnectionParms
  Inherits Component
C#
public class ULConnectionParms: Component
注释

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.DatabaseOnCE = "\UltraLite\mydb1.udb"
dbName.DatabaseOnDesktop = "somedir\mydb2.udb"

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

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

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

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 成员
ULConnectionParms 构造函数
AdditionalParms 属性
CacheSize 属性
ConnectionName 属性
DatabaseOnCE 属性
DatabaseOnDesktop 属性
EncryptionKey 属性
Password 属性
UserID 属性
ToString 方法
UnusedEvent 事件