DataTable.Rows-Eigenschaft
Ruft die Auflistung der Zeilen ab, die zu dieser Tabelle gehören.
Namespace: System.Data
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public ReadOnly Property Rows As DataRowCollection
'Usage
Dim instance As DataTable
Dim value As DataRowCollection
value = instance.Rows
public DataRowCollection Rows { get; }
public:
property DataRowCollection^ Rows {
DataRowCollection^ get ();
}
/** @property */
public DataRowCollection get_Rows ()
public function get Rows () : DataRowCollection
Eigenschaftenwert
Eine DataRowCollection, die DataRow-Objekte enthält, andernfalls ein NULL-Wert, wenn keine DataRow-Objekte vorhanden sind.
Hinweise
Um eine neue DataRow zu erstellen, müssen Sie die NewRow-Methode verwenden, um ein neues Objekt zurückzugeben. Solche Objekte werden automatisch dem Schema entsprechend konfiguriert, das für die DataTable über deren Auflistung von DataColumn-Objekten definiert wurde. Nach dem Erstellen einer neuen Zeile und dem Festlegen der Werte für die einzelnen Spalten der Zeile fügen Sie die Zeile mithilfe der Add-Methode der DataRowCollection hinzu.
Jede DataRow in der Auflistung stellt eine Datenzeile in der Tabelle dar. Um eine Änderung an einem Wert in einer Spalte in der Zeile zu übernehmen, müssen Sie die AcceptChanges-Methode aufrufen.
Beispiel
Im Folgenden werden zwei Beispiele für das Zurückgeben und Festlegen von Zeilen gezeigt. Im ersten Beispiel wird die Rows-Eigenschaft verwendet, und die Werte der einzelnen Spalten für jede Zeile werden ausgegeben. Im zweiten Beispiel wird mithilfe der NewRow-Methode des DataTable-Objekts ein neues DataRow-Objekt mit dem Schema der DataTable erstellt. Nach dem Festlegen der Zeilenwerte wird die Zeile mithilfe der Add-Methode der DataRowCollection hinzugefügt.
Private Sub PrintRows(dataSet As DataSet)
' For each table in the DataSet, print the values of each row.
Dim thisTable As DataTable
For Each thisTable In dataSet.Tables
' For each row, print the values of each column.
Dim row As DataRow
For Each row In thisTable.Rows
Dim column As DataColumn
For Each column In thisTable.Columns
Console.WriteLine(row(column))
Next column
Next row
Next thisTable
End Sub
Private Sub AddARow(dataSet As DataSet)
Dim table As DataTable = dataSet.Tables("Suppliers")
' Use the NewRow method to create a DataRow
'with the table's schema.
Dim newRow As DataRow = table.NewRow()
' Set values in the columns:
newRow("CompanyID") = "NewCompanyID"
newRow("CompanyName") = "NewCompanyName"
' Add the row to the rows collection.
table.Rows.Add(newRow)
End Sub
private void PrintRows(DataSet dataSet)
{
// For each table in the DataSet, print the values of each row.
foreach(DataTable thisTable in dataSet.Tables)
{
// For each row, print the values of each column.
foreach(DataRow row in thisTable.Rows)
{
foreach(DataColumn column in thisTable.Columns)
{
Console.WriteLine(row[column]);
}
}
}
}
private void AddARow(DataSet dataSet)
{
DataTable table;
table = dataSet.Tables["Suppliers"];
// Use the NewRow method to create a DataRow with
// the table's schema.
DataRow newRow = table.NewRow();
// Set values in the columns:
newRow["CompanyID"] = "NewCompanyID";
newRow["CompanyName"] = "NewCompanyName";
// Add the row to the rows collection.
table.Rows.Add(newRow);
}
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
DataTable-Klasse
DataTable-Member
System.Data-Namespace
AcceptChanges
DataRow-Klasse
DataRowCollection-Klasse
NewRow