次のコードは、label1 および label2 という名前の Label、txtConnectString という名前の TextBox、btnConnect という名前のボタン、txtSQLStatement という名前の TextBox、btnExecute という名前のボタン、dgResults という名前の DataGrid を宣言します。

private System.Windows.Forms.Label label1;
private System.Windows.Forms.TextBox txtConnectString;
private System.Windows.Forms.Label label2;
private System.Windows.Forms.Button btnConnect;
private System.Windows.Forms.TextBox txtSQLStatement;
private System.Windows.Forms.Button btnExecute;
private System.Windows.Forms.DataGrid dgResults;

SAConnection 型は、初期化されていない SQL Anywhere 接続オブジェクトを宣言するために使用されます。SAConnection オブジェクトは、SQL Anywhere データソースへの固有接続を表すために使用されます。

private SAConnection _conn;

SAConnection クラスの詳細については、SAConnection クラス [SQL Anywhere .NET]を参照してください。

txtConnectString オブジェクトの Text プロパティのデフォルト値は "Data Source=SQL Anywhere 12 Demo" です。アプリケーションユーザーは txtConnectString テキストボックスに新しい値を入力することで、この値を上書きできます。このデフォルト値がどのように設定されているかは、TableViewer.cs で「Windows Form Designer Generated Code」という記述のあるリージョンまたはセクションを開くことで確認できます。このセクションでは、次のコード行を探します。

this.txtConnectString.Text = "Data Source=SQL Anywhere 12 Demo";

SAConnection オブジェクトは、この接続文字列を使用してデータベースに接続します。次のコードは、SAConnection コンストラクターを使用して接続文字列の設定された新しい接続オブジェクトを作成します。その後、Open メソッドを使用して接続を確立します。

_conn = new SAConnection( txtConnectString.Text );
_conn.Open();

SAConnection コンストラクターの詳細については、SAConnection.SAConnection コンストラクター [SQL Anywhere .NET]を参照してください。

txtSQLStatement オブジェクトの Text プロパティのデフォルト値は "SELECT * FROM Employees" です。アプリケーションユーザーは txtSQLStatement テキストボックスに新しい値を入力することで、この値を上書きできます。

SQL 文は SACommand オブジェクトを使用して実行されます。次のコードは、SACommand コンストラクターを使用してコマンドオブジェクトを宣言し、作成します。このコンストラクターは、実行されるクエリを表す文字列と、クエリが実行される接続を表す SAConnection オブジェクトを受け入れます。

SACommand cmd = new SACommand( txtSQLStatement.Text.Trim(), _conn );

SACommand オブジェクトの詳細については、SACommand クラス [SQL Anywhere .NET]を参照してください。

クエリの結果は、SADataReader オブジェクトを使用して取得されます。次のコードは、ExecuteReader コンストラクターを使用して SADataReader オブジェクトを宣言し、作成します。このコンストラクターは、SACommand オブジェクトである cmd のメンバーであり、事前に宣言されています。ExecuteReader はコマンドテキストを実行するために接続に送信し、SADataReader を構築します。

SADataReader dr = cmd.ExecuteReader();

次のコードは、SADataReader オブジェクトを DataGrid オブジェクトに接続します。これにより結果カラムが画面に表示されるようになります。次に、SADataReader オブジェクトが閉じます。

dgResults.DataSource = dr;
dr.Close();

SADataReader オブジェクトの詳細については、SADataReader クラス [SQL Anywhere .NET]を参照してください。

アプリケーションがデータベースに接続しようとしたときや Tables コンボボックスにデータを移植するときにエラーが発生した場合、次のコードは、エラーを取得し、そのメッセージを表示します。

try {
  _conn = new SAConnection( txtConnectString.Text );
  _conn.Open();

  SACommand cmd = new SACommand( "SELECT table_name FROM sys.systable " +
      "WHERE creator = 101 AND table_type != 'TEXT'", _conn );
  SADataReader   dr = cmd.ExecuteReader();

  comboBoxTables.Items.Clear();
  while ( dr.Read() ) {
    comboBoxTables.Items.Add( dr.GetString( 0 ) );
  }
  dr.Close();
} catch( SAException ex ) {
  MessageBox.Show( ex.Errors[0].Source + " : " + ex.Errors[0].Message + " (" +
                   ex.Errors[0].NativeError.ToString() + ")",
                   "Failed to connect" );
}

SAException オブジェクトの詳細については、SAException クラス [SQL Anywhere .NET]を参照してください。