Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 10.0.1 » UltraLite - .NET Programming » Understanding UltraLite.NET Development » Accessing and manipulating data with the Table API

Accessing the values of the current row Next Page

Searching rows with find and lookup

UltraLite has several modes of operation for working with data. Two of these modes, the find and lookup modes, are used for searching. The Table object has methods corresponding to these modes for locating particular rows in a table.


The columns searched using Find and Lookup methods must be in the index used to open the table.

To search for a row
  1. Enter find or lookup mode.

    The mode is entered by calling a method on the table object. For example, the following code enters find mode.

  2. Set the search values.

    You do this by setting values in the current row. Setting these values affects the buffer holding the current row only, not the database. For example, the following code sets the value in the buffer to Kaminski.

    int lname = t.GetOrdinal( "lname" );
    t.SetString( lname, "Kaminski" );
  3. Search for the row.

    Use the appropriate method to carry out the search. For example, the following instruction looks for the first row that exactly matches the specified value in the current index.

    For multi-column indexes, a value for the first column is always used, but you can omit the other columns.

  4. Search for the next instance of the row.

    Use the appropriate method to carry out the search. For a find operation, FindNext locates the next instance of the parameters in the index. For a lookup, MoveNext locates the next instance.

See ULTable class.