Méthode setMaxRows (SQLServerStatement)

Télécharger le pilote JDBC

Définit la limite du nombre maximal de lignes que tout objet SQLServerResultSet peut contenir sur le nombre donné.

Syntaxe

  
public final void setMaxRows(int max)  

Paramètres

max

int indiquant le nombre maximal de lignes, ou 0 s’il n’y a pas de limite.

Exceptions

SQLServerException

Notes

Cette méthode setMaxRows est spécifiée par la méthode setMaxRows de l’interface java.sql.Statement.

Cette méthode setMaxRows n’a pas d’effet sur les curseurs dynamiques avec défilement. L'application doit utiliser la syntaxe SQL SELECT TOP N pour limiter le nombre de lignes retournées à partir de jeux de résultats potentiellement importants.

Lorsque la méthode setMaxRows est appelée, le pilote JDBC Microsoft pour SQL Server exécute l'SET ROWCOUNTinstruction SQL lorsqu'il exécute la requête de l'application. Cela entraîne le pilote JDBC à limiter le nombre maximal de lignes affectées par toutes les instructions Transact-SQL exécutées par cette requête, et non simplement le nombre de lignes retournées par cette requête. Si l’application doit définir une limite seulement pour l’objet SQLServerResultSet de plus haut niveau, elle doit utiliser la syntaxe SQL SELECT TOP N dans la requête à la place de la méthode setMaxRows.

Pour plus d’informations sur l’instruction SET ROWCOUNT SQL, voir le sujet «SET ROWCOUNT (Transact-SQL) » dans SQL Server Books Online.

Voir aussi

SQLServerStatement, membres
SQLServerStatement, classe