FileAdapter.SeekRRN Method
Definition
Namespace: ASNA.DataGate.Client
Assembly: ASNA.QSys.DataGate.Client.dll
Positions the file pointer at the record with the specified relative record number (RRN) in the file that the FileAdapter is working with.
void SeekRRN(SeekMode mode, long RRN)
Parameters
| Type | Parameter name | Description |
|---|---|---|
| SeekMode | mode | The SeekMode to use when seeking the record. |
| Int64 | RRN | The relative record number of the record to seek. |
Remarks
SeekRRN positions the file pointer to a particular record using the specified relative record number (RRN) and mode as a point of reference. The record pointed to by this method will be either relative to the RRN parameter (mode Equal, Greater, SetGT, SetGE, or SetLL); or, relative to the absolute position in the file (mode First or Last). If the record sought does not exist in the file, the method throws dgException with an Error property value of dgEaNOTFND.
When SeekMode.SetLL or SeekMode.SetGT values for mode are specified and the record sought is not found, the file pointer is placed at the end of the file and then dgException is thrown.
Calling this method cancels “range mode”. A prior successful call to ReadRangeor SeekRange places the FileAdapter in range mode, in which only records with keys in a specified range are accessed. This method cancels the restriction.