Paging durch ein Abfrageergebnis
Gilt für: 
.NET Framework .NET .NET Standard
Beim Paging durch ein Abfrageergebnis werden die Ergebnisse einer Abfrage in kleineren Untergruppen von Daten oder Seiten zurückgegeben. Dies ist eine allgemein übliche Vorgehensweise, um einem Benutzer Ergebnisse in kleinen Blöcken anzuzeigen, die sich leicht verwalten lassen.
Die SqlDataAdapter-Klasse stellt eine Funktion bereit, mit der durch Überladungen der Fill-Methode nur eine Seite mit Daten zurückgegeben wird. Dies ist jedoch möglicherweise nicht die beste Methode zum Einteilen umfangreicher Abfrageergebnisse in Seiten. Dies liegt daran, dass weiterhin die Ressourcen zum Zurückgeben der gesamten Abfrage verwendet werden, auch wenn die DataAdapter-Klasse das Ziel DataTable oder DataSet nur mit den angeforderten Datensätzen füllt.
Geben Sie zusätzliche Kriterien für Ihre Abfrage ein, um eine Seite mit Daten von einer Datenquelle ohne die Ressourcen zurückzugeben, die zum Zurückgeben der gesamten Abfrage erforderlich sind, sodass nur die erforderlichen Zeilen zurückgegeben werden.
Wenn Sie die Fill-Methode zum Zurückgeben einer Seite mit Daten verwenden möchten, legen Sie für den ersten Datensatz auf der Datenseite einen startRecord-Parameter fest und für die Anzahl von Datensätzen auf der Datenseite einen maxRecords-Parameter.
Beispiel
Im folgenden Codebeispiel wird gezeigt, wie mit der Fill-Methode die erste Seite mit fünf Datensätzen eines Abfrageergebnisses zurückgegeben wird.
int currentIndex = 0;
int pageSize = 5;
string orderSQL = "SELECT * FROM Orders ORDER BY OrderID";
// Assumes that connection is a valid SqlConnection object.
SqlDataAdapter adapter = new SqlDataAdapter(orderSQL, connection);
DataSet dataSet = new DataSet();
adapter.Fill(dataSet, currentIndex, pageSize, "Orders");
Im vorherigen Beispiel wird die DataSet-Klasse nur mit fünf Datensätzen gefüllt, aber die gesamte Orders-Tabelle zurückgegeben. Verwenden Sie die Klauseln TOP und WHERE in Ihrer SQL-Anweisung wie im folgenden Codebeispiel gezeigt, um die DataSet-Klasse mit diesen fünf Datensätzen zu füllen, aber nur fünf Datensätze zurückzugeben.
int pageSize = 5;
string orderSQL = "SELECT TOP " + pageSize +
" * FROM Orders ORDER BY OrderID";
// Assumes that connection is a valid SqlConnection object.
SqlDataAdapter adapter = new SqlDataAdapter(orderSQL, connection);
DataSet dataSet = new DataSet();
adapter.Fill(dataSet, "Orders");
Hinweis
Wenn Sie die Abfrageergebnisse auf diese Weise in Seiten einteilen, müssen Sie den eindeutigen Bezeichner, mit dem die Zeilen sortiert werden, beibehalten, um die eindeutige ID an den Befehl zu übergeben, um die nächste Seite mit Datensätzen zurückzugeben, wie im folgenden Codebeispiel gezeigt.
string lastRecord =
dataSet.Tables["Orders"].Rows[pageSize - 1]["OrderID"].ToString();
Wenn Sie die nächste Seite mit Datensätzen durch Überladen der Fill-Methode mit den Parametern startRecord und maxRecords zurückgeben möchten, müssen Sie den aktuellen Datensatzindex um die Seitengröße erhöhen und die Tabelle füllen.
Hinweis
Denken Sie daran, dass der Datenbankserver alle Abfrageergebnisse zurückgibt, auch wenn nur eine Seite mit Datensätzen zur DataSet-Klasse hinzugefügt wird.
Im folgenden Codebeispiel wird der Inhalt der Tabellenzeilen gelöscht, bevor sie mit der nächsten Seite mit Daten gefüllt werden. Möglicherweise soll eine bestimmte Anzahl zurückgegebener Zeilen in einem lokalen Cache beibehalten werden, um die Anzahl der Schleifen zum Datenbankserver zu reduzieren.
currentIndex += pageSize;
// Assumes that dataset and adapter are valid objects.
dataSet.Tables["Orders"].Rows.Clear();
adapter.Fill(dataSet, currentIndex, pageSize, "Orders");
Geben Sie restriktive Kriterien für die SQL-Anweisung SELECT an, um die nächste Seite mit Datensätzen zurückzugeben, ohne dass der Datenbankserver die gesamte Abfrage zurückgeben muss. Da im vorhergehenden Beispiel der zuletzt zurückgegebene Datensatz beibehalten wurde, können Sie ihn in der WHERE-Klausel verwenden, um – wie im folgenden Codebeispiel gezeigt – einen Ausgangspunkt für die Abfrage anzugeben.
orderSQL = "SELECT TOP " + pageSize +
" * FROM Orders WHERE OrderID > " + lastRecord + " ORDER BY OrderID";
adapter.SelectCommand.CommandText = orderSQL;
dataSet.Tables["Orders"].Rows.Clear();
adapter.Fill(dataSet, "Orders");