setMaxRows-Methode (SQLServerStatement)
Legt den Grenzwert für die maximale Anzahl von Zeilen, die ein beliebiges SQLServerResultSet-Objekt enthalten kann, auf die angegebene Anzahl fest.
Syntax
public final void setMaxRows(int max)
Parameter
max
Ein Wert vom Typ int zum Angeben der maximalen Zeilenanzahl oder 0 (null), wenn kein Grenzwert vorhanden ist.
Ausnahmen
Bemerkungen
Diese setMaxRows-Methode wird von der setMaxRows-Methode in der java.sql.Statement-Schnittstelle angegeben.
Diese setMaxRows-Methode hat keine Auswirkungen auf dynamische scrollbare Cursor. Von der Anwendung sollte die Anzahl von Zeilen, die von potenziell umfangreichen Resultsets zurückgegeben wird, mithilfe der SQL-Syntax "SELECT TOP N" eingeschränkt werden.
Wenn die setMaxRows-Methode aufgerufen wird, wird von Microsoft JDBC-Treiber für SQL Server beim Ausführen der Anwendungsabfrage die SQL-Anweisung SET ROWCOUNT ausgeführt. Dadurch wird die maximale Anzahl von Zeilen beschränkt, die von Anweisungen vom Typ "Transact-SQL" betroffen sind, welche von dieser Abfrage ausgeführt werden (und nicht nur die Anzahl von Zeilen, die von dieser Abfrage zurückgegeben werden). Wenn von der Anwendung lediglich ein Grenzwert für das oberste SQLServerResultSet-Objekt festgelegt werden muss, muss in der Abfrage anstelle der setMaxRows-Methode die SQL-Syntax SELECT TOP N verwendet werden.
Weitere Informationen zur SQL-Anweisung SET ROWCOUNT finden Sie in der SQL Server-Onlinedokumentation unter SET ROWCOUNT (Transact-SQL).