DataTable.Rows Property

Definition

Obtiene la colección de filas que pertenecen a esta tabla.Gets the collection of rows that belong to this table.

public:
 property System::Data::DataRowCollection ^ Rows { System::Data::DataRowCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Data.DataRowCollection Rows { 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

Property Value

DataRowCollection

DataRowCollection que contiene objetos DataRow; en caso contrario, valor nulo si no existe ningún objeto DataRow.A DataRowCollection that contains DataRow objects; otherwise a null value if no DataRow objects exist.

Attributes

Examples

A continuación se muestran dos ejemplos de cómo devolver y establecer filas.The following shows two examples of returning and setting rows. En el primer ejemplo se usa la propiedad Rows y se imprime el valor de cada columna para cada fila.The first example uses the Rows property and prints the value of each column for every row. En el segundo ejemplo se usa el método NewRow del objeto DataTable para crear un nuevo objeto DataRow con el esquema del DataTable.The second example uses the DataTable object's NewRow method to create a new DataRow object with the schema of the DataTable. Después de establecer los valores de fila, la fila se agrega al DataRowCollection a través del método Add.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

Remarks

Para crear un nuevo DataRow, debe utilizar el método NewRow para devolver un nuevo objeto.To create a new DataRow, you must use the NewRow method to return a new object. Este tipo de objeto se configura automáticamente según el esquema definido para la DataTable a través de su colección de objetos DataColumn.Such an object is automatically configured according to the schema defined for the DataTable through its collection of DataColumn objects. Después de crear una nueva fila y establecer los valores de cada columna de la fila, agregue la fila al DataRowCollection mediante el método Add.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.

Cada DataRow de la colección representa una fila de datos de la tabla.Each DataRow in the collection represents a row of data in the table. Para confirmar un cambio en el valor de una columna de la fila, debe invocar el método AcceptChanges.To commit a change to the value of a column in the row, you must invoke the AcceptChanges method.

Applies to

See also