对数据执行任何操作之前，您的应用程序必须先连接到数据库。本节介绍如何通过编写代码连接到 SQL Anywhere 数据库。

有关详细信息，请参见SAConnectionStringBuilder 类和ConnectionName 属性。

♦  连接到 SQL Anywhere 数据库

1. 分配 SAConnection 对象。

   以下代码创建一个名为 conn 的 SAConnection 对象：

   SAConnection conn = new SAConnection(connection-string)

   应用程序与数据库之间可以建立多个连接。某些应用程序只与 SQL Anywhere 数据库建立一个连接，并且该连接始终保持打开状态。为此，可以为连接声明一个全局变量：

   private SAConnection _conn;

   有关详细信息，请参见 samples-dir\SQLAnywhere\ADO.NET\TableViewer 和了解 Table Viewer 示例项目中的示例代码。

2. 指定用于连接到数据库的连接字符串。

   例如：

   "Data Source=SQL Anywhere 11 Demo"

   有关连接参数的完整列表，请参见连接参数。

   可以不提供连接字符串，而是提示用户输入他们的用户 ID 和口令。

3. 打开一个与数据库的连接。

   以下代码尝试连接到数据库。它会在需要时自动启动数据库服务器。

   conn.Open();

4. 捕获连接错误。

   您的应用程序应设计为捕获尝试连接数据库时出现的任何错误。以下代码演示如何捕获错误并显示其消息：

   try { _conn = new SAConnection( txtConnectString.Text ); _conn.Open(); } catch( SAException ex ) { MessageBox.Show( ex.Errors[0].Source + " : " + ex.Errors[0].Message + " (" + ex.Errors[0].NativeError.ToString() + ")", "Failed to connect" );

   或者，可以使用 ConnectionString 属性设置连接字符串，而不是在创建 SAConnection 对象时传递连接字符串：

   SAConnection _conn; _conn = new SAConnection(); _conn.ConnectionString = "Data Source=SQL Anywhere 11 Demo"; _conn.Open();

5. 关闭与数据库的连接。与数据库的连接会一直保持打开状态，直到使用 conn.Close() 方法将它们显式关闭。

Visual Basic 连接示例

以下 Visual Basic 代码打开一个与 SQL Anywhere 示例数据库的连接：

Private Sub Button1_Click(ByVal sender As _
    System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click
    ' Declare the connection object
    Dim myConn As New _
      iAnywhere.Data.SQLAnywhere.SAConnection()
    myConn.ConnectionString = _
      "Data Source=SQL Anywhere 11 Demo"
    myConn.Open()
    myConn.Close()
End Sub