setMaxRows-Methode (ISQLServerStatement)
Legt das Limit 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 ("0", wenn kein Limit vorhanden ist).
Ausnahmen
Hinweise
Diese setMaxRows-Methode wird von der setMaxRows-Methode in der java.sql.Statement-Schnittstelle angegeben.
Diese setMaxRows-Methode hat keine Auswirkungen auf dynamische, scrollfähige 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 SQL Server JDBC Driver 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). Muss von der Anwendung lediglich ein Limit für das oberste SQLServerResultSet-Objekt festgelegt werden, 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 im Thema "SET ROWCOUNT (Transact-SQL)".