Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Při aktualizaci řádku záložkou sqlBulkOperations aktualizuje zdroj dat jeden nebo více řádků tabulky. Řádky jsou identifikovány záložkou ve vázaném sloupci záložky. Řádek se aktualizuje pomocí dat v vyrovnávací paměti aplikace pro každý vázaný sloupec (s výjimkou případů, kdy je hodnota v vyrovnávací paměti délky nebo indikátoru pro sloupec SQL_COLUMN_IGNORE). Nevázané sloupce nebudou aktualizovány.
Chcete-li aktualizovat řádky pomocí záložek prostřednictvím SQLBulkOperations, postupujte podle následujících kroků:
Načte a uloží do mezipaměti záložky všech řádků, které se mají aktualizovat. Pokud existuje více než jedna záložka a používá se vazba pro sloupce, záložky jsou uloženy v poli; pokud existuje více záložek a používá se vazba s řádky, záložky se ukládají do pole struktur řádků.
Nastaví atribut příkazu SQL_ATTR_ROW_ARRAY_SIZE na počet záložek a připojí vyrovnávací paměť obsahující hodnotu záložky nebo pole záložek ke sloupci 0.
Umístí nové hodnoty dat do vyrovnávací paměti sady řádků. Informace o tom, jak odesílat dlouhá data pomocí SQLBulkOperations, naleznete v tématu Long Data a SQLSetPos a SQLBulkOperations.
Nastaví hodnotu ve vyrovnávací paměti pro délku/indikátor každého sloupce podle potřeby. Jedná se o bajtovou délku dat nebo SQL_NTS pro sloupce vázané na vyrovnávací paměti řetězců, bajtovou délku dat pro sloupce vázané na binární vyrovnávací paměti a SQL_NULL_DATA pro všechny sloupce, které mají být nastaveny na hodnotu NULL.
Nastaví hodnotu ve vyrovnávací paměti délky/ukazatele těch sloupců, které nemají být aktualizovány na SQL_COLUMN_IGNORE. I když aplikace může tento krok přeskočit a znovu odeslat existující data, je to neefektivní a riziko odesílání hodnot do zdroje dat, které byly zkráceny při jejich čtení.
Volá SQLBulkOperations s argumentem Operace nastaveným na SQL_UPDATE_BY_BOOKMARK.
Pro každý řádek, který je odeslán do zdroje dat jako aktualizace, by vyrovnávací paměti aplikace měly mít platná data řádku. Pokud byly vyrovnávací paměti aplikace vyplněny načtením, pokud bylo zachováno pole stavu řádku a pokud je hodnota stavu řádku SQL_ROW_DELETED, SQL_ROW_ERROR nebo SQL_ROW_NOROW, mohla by se do zdroje dat neúmyslně odeslat neplatná data.