Rijen schuiven en ophalen (ODBC)

Wanneer u een schuifbare cursor gebruikt, roepen toepassingen SQLFetchScroll aan om de cursor te plaatsen en rijen op te halen. SQLFetchScroll biedt ondersteuning voor relatieve scrolling (volgende, vorige en relatieve n rijen), absoluut schuiven (eerste, laatste en rij n) en positie per bladwijzer. De argumenten FetchOrientation en FetchOffset in SQLFetchScroll geven op welke rijenset moet worden opgehaald, zoals wordt weergegeven in de volgende diagrammen.

Volgende, Vorige, Eerste en Laatste rijensets ophalen

Absolute, relatieve en bladwijzerrijsets ophalen

SQLFetchScroll plaatst de cursor op de opgegeven rij en retourneert de rijen in de rijenset die beginnen met die rij. Als de opgegeven rijenset het einde van de resultatenset overlapt, wordt een gedeeltelijke rijenset geretourneerd. Als de opgegeven rijenset het begin van de resultatenset overlapt, wordt meestal de eerste rijset in de resultatenset geretourneerd; Zie de beschrijving van de functie SQLFetchScroll voor volledige details.

In sommige gevallen kan het zijn dat de toepassing de cursor wilt plaatsen zonder gegevens op te halen. Het kan bijvoorbeeld nodig zijn om te testen of er een rij bestaat of alleen de bladwijzer voor de rij op te halen zonder dat er andere gegevens over het netwerk worden verzonden. Hiervoor wordt het instructiekenmerk SQL_ATTR_RETRIEVE_DATA ingesteld op SQL_RD_OFF. De variabele die is gebonden aan de bladwijzerkolom (indien van toepassing) wordt altijd bijgewerkt, ongeacht de instelling van dit instructiekenmerk.

Nadat de rijset is opgehaald, kan de toepassing SQLSetPos aanroepen om een bepaalde rij in de rijenset te plaatsen of rijen in de rijset te vernieuwen. Zie Gegevens bijwerken met SQLSetPos voor meer informatie over het gebruik van SQLSetPos.