dotConnect for Zoho Books Documentation
Devart.Data.ZohoBooks Namespace / ZohoBooksCommand Class
Members Example

ZohoBooksCommand Class
Represents a SQL statement or stored procedure to execute against Zoho Books.
Syntax
Remarks
The ZohoBooksCommand class provides the following methods for executing commands against Zoho Books:
Item Description
ExecuteReader Executes commands that return rows.
Devart.Common.DbCommandBase.ExecutePageReader Returns a specific subset of rows when paging through the results of a query.
ExecuteNonQuery Executes SQL commands such as INSERT, DELETE, UPDATE.
ExecuteScalar Retrieves a single value (for example, an aggregate value) from a data source.

If execution of the command results in a fatal ZohoBooksException, the ZohoBooksConnection may close. However, the user can reopen the connection and continue.

Example
The following example uses the ExecuteReader method of ZohoBooksCommand, along with ZohoBooksDataReader and ZohoBooksConnection, to select rows from a table.
public void ReadMyData(string myConnString)
{
  string mySelectQuery = "SELECT AccountID, \"Account Name\" FROM Accounts";
  ZohoBooksConnection ZohoBooksConnection = new ZohoBooksConnection(myConnString);
  ZohoBooksCommand ZohoBooksCommand = new ZohoBooksCommand(mySelectQuery,ZohoBooksConnection);
  ZohoBooksConnection.Open();
  ZohoBooksDataReader ZohoBooksReader = ZohoBooksCommand.ExecuteReader();
  try
  {
    while (ZohoBooksReader.Read())
    {
      Console.WriteLine(ZohoBooksReader.GetString(0) + ", " + ZohoBooksReader.GetString(1));
    }
  }
  finally
  {
  // always call Close when done reading.
  ZohoBooksReader.Close();
  // always call Close when done reading.
  ZohoBooksConnection.Close();
  }
}
Public Sub ReadMyData(myConnString As String)
  Dim mySelectQuery As String = "SELECT AccountID, \"Account Name\" FROM Accounts"
  Dim ZohoBooksConnection As New ZohoBooksConnection(myConnString)
  Dim ZohoBooksCommand As New ZohoBooksCommand(mySelectQuery, ZohoBooksConnection)
  ZohoBooksConnection.Open()
  Dim ZohoBooksReader As ZohoBooksDataReader = ZohoBooksCommand.ExecuteReader()
  Try
    While ZohoBooksReader.Read()
      Console.WriteLine(ZohoBooksReader.GetString(0) + ", " _
        + ZohoBooksReader.GetString(1))
    End While
  Finally
      ' always call Close when done reading.
      ZohoBooksReader.Close()
      ' always call Close when done with connection.
      ZohoBooksConnection.Close()
  End Try
End Sub
Inheritance Hierarchy

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Data.Common.DbCommand
            Devart.Common.DbCommandBase
               Devart.Data.SqlShimCommand
                  Devart.Data.ZohoBooks.ZohoBooksCommand

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also