连接到数据库

UltraLite 应用程序必须先连接到数据库，然后才能对数据库中的数据进行操作。本节介绍如何连接到 UltraLite 数据库。

ULConnection 对象的以下属性控制着全局应用程序行为。

提交行为 缺省情况下，UltraLite.NET 应用程序处于 AutoCommit 模式。每个 Insert、Update 或 Delete 语句都会立即提交给数据库。可以使用 ULConnection.BeginTransaction 在应用程序中定义事务的起点。请参见管理事务。
用户验证 您可以使用授予或撤消连接权限的方法更改应用程序的用户 ID 缺省值 DBA 和口令缺省值 sql。每个 UltraLite 数据库最多可以定义四个用户 ID。请参见验证用户。
同步可以通过 Connection 对象访问用于控制同步的一组对象。请参见UltraLite 应用程序中的同步。
表使用 Connection 对象的方法可以访问 UltraLite 表。请参见使用 Table API 访问和操作数据。
命令系统提供了一组对象来处理动态 SQL 语句的执行以及浏览结果集。请参见使用 SQL 访问和操作数据。

每个 ULConnection 以及从中创建的所有对象都应该在单个线程中使用。如果您的应用程序需要使用多个线程访问 UltraLite 数据库，则每个线程都需要一个单独的连接。例如，如果您将应用程序设计为在一个单独的线程中执行同步，则必须使用单独的连接来实现同步，而且必须从该线程中打开连接。

声明一个 ULConnection 对象。

大多数应用程序都使用一个与 UltraLite 数据库的连接，并使该连接保持打开状态。只有多线程数据访问才需要多个连接。因此，通常最好将 ULConnection 对象声明为应用程序范围内的全局对象。
ULConnection conn;

打开与现有数据库的连接。

UltraLite 应用程序必须部署初始数据库文件，或者应用程序必须包含用来创建数据库文件的代码。可以使用 Sybase Central 或 UltraLite 提供的命令行实用程序来创建初始数据库文件。

您可以使用连接字符串的形式或者使用 ULConnectionParms 对象来指定连接参数。下例说明了如何使用 ULConnectionParms 对象来连接名为 mydata.udb 的 UltraLite 数据库。

ULConnectionParms parms = new ULConnectionParms();
parms.DatabaseOnDesktop = "mydata.udb";
conn = new ULConnection( parms.ToString() );
conn.Open();

本章的代码示例是用 Microsoft C# 编写的。如果您使用的是其它某种受支持的开发工具，则必须相应地修改指令。

使用DocCommentXchange 讨论此页。