Aktualizowanie wierszy według zakładki za pomocą poleceń SQLBulkOperations

Podczas aktualizowania wiersza według zakładki program SQLBulkOperations sprawia, że źródło danych aktualizuje co najmniej jeden wiersz tabeli. Wiersze są identyfikowane za pomocą zakładki znajdującej się w kolumnie powiązanej z zakładkami. Wiersz jest aktualizowany przy użyciu danych w buforach aplikacji dla każdej powiązanej kolumny (z wyjątkiem sytuacji, gdy wartość w buforze długości/wskaźnika dla kolumny to SQL_COLUMN_IGNORE). Kolumny niepowiązane nie zostaną zaktualizowane.

Aby zaktualizować wiersze za pomocą zakładki i SQLBulkOperations, aplikacja:

1. Pobiera i buforuje zakładki wszystkich wierszy do zaktualizowania. Jeśli istnieje więcej niż jedna zakładka i używane jest powiązanie kolumnowe, zakładki są przechowywane w tablicy; jeśli istnieje więcej niż jedna zakładka i używane jest powiązanie wierszowe, zakładki są przechowywane w tablicy struktur wierszy.

2. Ustawia atrybut instrukcji SQL_ATTR_ROW_ARRAY_SIZE na liczbę zakładek i wiąże bufor zawierający wartość zakładki lub tablicę zakładek na kolumnę 0.

3. Umieszcza nowe wartości danych w buforach zestawu wierszy. Aby uzyskać informacje na temat wysyłania długich danych za pomocą SQLBulkOperations, zobacz Long Data and SQLSetPos and SQLBulkOperations.

4. Ustawia wartość w buforze długości/wskaźnika dla każdej kolumny zgodnie z potrzebami. Jest to długość bajtów danych lub SQL_NTS dla kolumn powiązanych z buforami znakowymi, długość bajtów danych dla kolumn powiązanych z buforami binarnymi oraz SQL_NULL_DATA dla wszystkich kolumn, które mają być ustawione na wartość NULL.

5. Ustawia wartość w buforze długości/wskaźnika tych kolumn, które nie mają być aktualizowane na SQL_COLUMN_IGNORE. Mimo że aplikacja może pominąć ten krok i ponownie wysłać istniejące dane, jest to nieefektywne i wiąże się z ryzykiem wysyłania wartości do źródła danych, które zostały przycięte podczas ich odczytu.

6. Wywołuje metodę SQLBulkOperations z argumentem Operation ustawionym na SQL_UPDATE_BY_BOOKMARK.

Dla każdego wiersza wysyłanego do źródła danych jako aktualizacja, bufory aplikacji powinny zawierać prawidłowe dane wiersza. Jeśli bufory aplikacji zostały wypełnione podczas pobierania, jeśli tablica stanu wiersza została zachowana, a wartość stanu dla wiersza to SQL_ROW_DELETED, SQL_ROW_ERROR lub SQL_ROW_NOROW, nieprawidłowe dane mogą przypadkowo zostać wysłane do źródła danych.