DataTable.Rows Eigenschaft

Definition

Ruft die Auflistung der Zeilen ab, die zu dieser Tabelle gehören.Gets the collection of rows that belong to this table.

public:
 property System::Data::DataRowCollection ^ Rows { System::Data::DataRowCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
[System.Data.DataSysDescription("DataTableRowsDescr")]
public System.Data.DataRowCollection Rows { get; }
member this.Rows : System.Data.DataRowCollection
Public ReadOnly Property Rows As DataRowCollection

Eigenschaftswert

Eine DataRowCollection, die DataRow-Objekte enthält, andernfalls ein NULL-Wert, wenn keine DataRow-Objekte vorhanden sind.A DataRowCollection that contains DataRow objects; otherwise a null value if no DataRow objects exist.

Attribute

Beispiele

Das folgende Beispiel zeigt zwei Beispiele für das zurückgeben und Festlegen von Zeilen.The following shows two examples of returning and setting rows. Im ersten Beispiel wird die Rows -Eigenschaft verwendet, und der Wert jeder Spalte wird für jede Zeile ausgegeben.The first example uses the Rows property and prints the value of each column for every row. Im zweiten Beispiel wird die DataTable -Methode NewRow des-Objekts verwendet, DataRow um ein neues-Objekt mit DataTabledem Schema von zu erstellen.The second example uses the DataTable object's NewRow method to create a new DataRow object with the schema of the DataTable. Nach dem Festlegen der Zeilen Werte wird die Zeile mithilfe der DataRowCollection Add -Methode hinzugefügt.After setting the row values, the row is added to the DataRowCollection through the Add method.

   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);
   }
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

Hinweise

Um ein neues DataRowzu erstellen, müssen Sie die NewRow -Methode verwenden, um ein neues-Objekt zurückzugeben.To create a new DataRow, you must use the NewRow method to return a new object. Ein solches Objekt wird automatisch gemäß dem Schema konfiguriert, das durch seine DataTable Auflistung von DataColumn -Objekten für das definiert wird.Such an object is automatically configured according to the schema defined for the DataTable through its collection of DataColumn objects. Nachdem Sie eine neue Zeile erstellt und die Werte für jede Spalte in der Zeile festgelegt haben, fügen Sie DataRowCollection die Zeile Add mithilfe der-Methode hinzu.After creating a new row and setting the values for each column in the row, add the row to the DataRowCollection using the Add method.

Jede DataRow in der Auflistung stellt eine Zeile mit Daten in der Tabelle dar.Each DataRow in the collection represents a row of data in the table. Um eine Änderung des Werts einer Spalte in der Zeile zu übertragen, müssen Sie die AcceptChanges -Methode aufrufen.To commit a change to the value of a column in the row, you must invoke the AcceptChanges method.

Gilt für:

Siehe auch