Delen via

sp_cursoroption (Transact-SQL)

  • Artikel

van toepassing op:SQL Server-

Hiermee stelt u cursoropties in of retourneert u cursorgegevens die zijn gemaakt door de sp_cursoropen opgeslagen procedure. sp_cursoroption wordt aangeroepen door ID = 8 op te geven in een TDS-pakket (tabellaire gegevensstroom).

Transact-SQL syntaxisconventies

Syntaxis

sp_cursoroption cursor , code , value
[ ; ]

Argumenten

Belangrijk

Argumenten voor uitgebreide opgeslagen procedures moeten worden ingevoerd in de specifieke volgorde, zoals beschreven in de sectie Syntaxis. Als de parameters niet in de volgorde zijn ingevoerd, treedt er een foutbericht op.

cursor

Een handle waarde die wordt gegenereerd door SQL Server en geretourneerd door de sp_cursoropen opgeslagen procedure. De cursor parameter is int en kan niet worden NULL.

code

Wordt gebruikt om verschillende factoren van de retourwaarden van de cursor te bepalen. De parameter code is inten moet een van de volgende waarden zijn:

Waarde Naam Beschrijving
0x0001 TEXTPTR_ONLY Retourneert de tekstwijzer en niet de werkelijke gegevens voor bepaalde aangewezen tekst- of afbeeldingskolommen.

TEXTPTR_ONLY staat toe dat tekstpointers worden gebruikt als ingangen naar blobobjecten die later selectief kunnen worden opgehaald of bijgewerkt met behulp van Transact-SQL of DBLIB-faciliteiten (bijvoorbeeld Transact-SQL READTEXT of DBLIB-DBWRITETEXT).
Als er een 0 waarde is toegewezen, retourneren alle tekst- en afbeeldingskolommen in de selectielijst tekstpunten in plaats van gegevens.
0x0002 CURSOR_NAME Wijst de naam die is opgegeven in waarde toe aan de cursor, zodat ODBC Transact-SQL UPDATE/DELETE instructies kan gebruiken voor cursors die via sp_cursoropenworden geopend.

De tekenreeks kan worden opgegeven als elk teken of Unicode-gegevenstype.
Aangezien Transact-SQL UPDATE/DELETE instructies standaard worden gebruikt op de eerste rij in een vetcursor, moet sp_cursor SETPOSITION worden gebruikt om de cursor te plaatsen voordat de positie van de UPDATE/DELETE-instructie wordt uitgegeven.
0x0003 TEXTDATA Retourneert de werkelijke gegevens, niet de tekstwijzer, voor bepaalde tekst- of afbeeldingskolommen bij volgende ophaalt (dit maakt het effect van TEXTPTR_ONLYongedaan).

Als TEXTDATA is ingeschakeld voor een bepaalde kolom, wordt de rij opnieuw geactiveerd of vernieuwd en kan deze weer worden ingesteld op TEXTPTR_ONLY. Net als bij TEXTPTR_ONLYis de waardeparameter een geheel getal dat het kolomnummer aangeeft en een nulwaarde alle tekst- of afbeeldingskolommen retourneert.
0x0004 SCROLLOPT Schuifoptie. Zie Retourcodewaardenvoor meer informatie.
0x0005 CCOPT Optie voor gelijktijdigheidsbeheer. Zie Retourcodewaardenvoor meer informatie.
0x0006 ROWCOUNT Het aantal rijen dat zich momenteel in de resultatenset bevindt.

Opmerking: De ROWCOUNT kan zijn gewijzigd sinds de waarde die door sp_cursoropen wordt geretourneerd als asynchrone populatie wordt gebruikt. De waarde -1 wordt geretourneerd als het aantal rijen onbekend is.

waarde

Geeft de waarde aan die wordt geretourneerd door code. waarde is een vereiste parameter die een 0x0001, 0x0002of 0x0003code invoerwaarde aanroept.

Een -code waarde van 2 is een gegevenstype tekenreeks. Elke andere code waardeinvoer of geretourneerd door waarde is een int.

Codewaarden retourneren

De waarde parameter kan een van de volgende code waarden retourneren.

Retourwaarde Beschrijving
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

De waarde parameter retourneert een van de volgende SCROLLOPT waarden.

Retourwaarde Beschrijving
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

De waarde parameter retourneert een van de volgende CCOPT waarden.

Retourwaarde Beschrijving
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC

Verwante inhoud