Access data using the SACommand object

The SACommand object allows you to execute a SQL statement or call a stored procedure against a SQL Anywhere database. You can use any of the following methods to retrieve data from the database:

ExecuteReader Issues a SQL query that returns a result set. This method uses a forward-only, read-only cursor. You can loop quickly through the rows of the result set in one direction.
ExecuteScalar Issues a SQL query that returns a single value. This can be the first column in the first row of the result set, or a SQL statement that returns an aggregate value such as COUNT or AVG. This method uses a forward-only, read-only cursor.

When using the SACommand object, you can use the SADataReader to retrieve a result set that is based on a join. However, you can only make changes (inserts, updates, or deletes) to data that is from a single table. You cannot update result sets that are based on joins.

When using the SADataReader, there are several Get methods available that you can use to return the results in the specified data type.

C# ExecuteReader example

The following C# code opens a connection to the SQL Anywhere sample database and uses the ExecuteReader method to create a result set containing the last names of employees in the Employees table:

SAConnection conn = new SAConnection("Data Source=SQL Anywhere 12 Demo");
conn.Open();
SACommand cmd = new SACommand("SELECT Surname FROM Employees", conn);
SADataReader reader = cmd.ExecuteReader();
listEmployees.BeginUpdate();
while (reader.Read())
{
    listEmployees.Items.Add(reader.GetString(0));
}
listEmployees.EndUpdate();
reader.Close();
conn.Close();

Visual Basic ExecuteReader example

The following Visual Basic code opens a connection to the SQL Anywhere sample database and uses the ExecuteReader method to create a result set containing the last names of employees in the Employees table:

Dim myConn As New SAConnection()
myConn.ConnectionString = "Data Source=SQL Anywhere 12 Demo"
Dim myCmd As New SACommand("SELECT Surname FROM Employees", myConn)
Dim myReader As SADataReader

myConn.Open()
myReader = myCmd.ExecuteReader()
ListEmployees.BeginUpdate()
Do While (myReader.Read())
    ListEmployees.Items.Add(myReader.GetString(0))
Loop
ListEmployees.EndUpdate()
myConn.Close()

C# ExecuteScalar example

The following C# code opens a connection to the SQL Anywhere sample database and uses the ExecuteScalar method to obtain a count of the number of male employees in the Employees table:

SAConnection conn = new SAConnection("Data Source=SQL Anywhere 12 Demo");
conn.Open();
SACommand cmd = new SACommand(
    "SELECT COUNT(*) FROM Employees WHERE Sex = 'M'", conn );
int count = (int) cmd.ExecuteScalar();
textBox1.Text = count.ToString();
conn.Close();

Access data using the SACommand object

C# ExecuteReader example

Visual Basic ExecuteReader example

C# ExecuteScalar example

See also