Hämtar rader med SQLBulkOperations

Data kan hämtas till en raduppsättning med hjälp av bokmärken genom ett anrop till SQLBulkOperations. De rader som ska hämtas identifieras av bokmärkena i en bunden bokmärkeskolumn. Kolumner med värdet SQL_COLUMN_IGNORE hämtas inte.

För att utföra masshämtningar med SQLBulkOperations gör programmet följande:

1. Hämtar och cachelagrar bokmärken för alla rader som ska uppdateras. Om det finns fler än ett bokmärke och kolumnmässigt bindning används lagras bokmärkena i en matris. Om det finns fler än ett bokmärke och radvis bindning används lagras bokmärkena i en matris med radstrukturer.

2. Anger SQL_ATTR_ROW_ARRAY_SIZE-instruktionsattributet till antalet rader som ska hämtas och binder bufferten som innehåller bokmärkesvärdet, eller matrisen med bokmärken, till kolumn 0.

3. Anger värdet i längden/indikatorbufferten för varje kolumn efter behov. Det här är bytelängden för data eller SQL_NTS för kolumner som är bundna till strängbuffertar, bytelängden för data för kolumner som är bundna till binära buffertar och SQL_NULL_DATA för kolumner som ska anges till NULL. Programmet anger värdet i längden/indikatorbufferten för de kolumner som ska anges till standardvärdet (om det finns någon) eller NULL (om det inte finns) till SQL_COLUMN_IGNORE.

4. Anropar SQLBulkOperations med argumentet Operation inställt på SQL_FETCH_BY_BOOKMARK.

Programmet behöver inte använda radåtgärdsmatrisen för att förhindra att åtgärden utförs på vissa kolumner. Programmet väljer de rader som ska hämtas genom att endast kopiera bokmärkena för dessa rader till den bundna bokmärkesmatrisen.