DataTable.Rows DataTable.Rows DataTable.Rows DataTable.Rows Property

Définition

Obtient la collection des lignes qui appartiennent à cette table.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

Valeur de propriété

DataRowCollection qui contient des objets DataRow, ou une valeur null s'il n'existe aucun objet DataRow.A DataRowCollection that contains DataRow objects; otherwise a null value if no DataRow objects exist.

Exemples

L’exemple suivant montre deux exemples de retour et de définition de lignes.The following shows two examples of returning and setting rows. Le premier exemple utilise la Rows propriété et imprime la valeur de chaque colonne pour chaque ligne.The first example uses the Rows property and prints the value of each column for every row. Le deuxième exemple utilise la DataTable NewRow méthode de l’objet pour créer un DataRow nouvel objet avec le schéma de DataTable.The second example uses the DataTable object's NewRow method to create a new DataRow object with the schema of the DataTable. Après avoir défini les valeurs de ligne, la ligne est ajoutée DataRowCollection au à Add l’aide de la méthode.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

Remarques

Pour créer un nouvel DataRowobjet, vous devez utiliser NewRow la méthode pour retourner un nouvel objet.To create a new DataRow, you must use the NewRow method to return a new object. Un tel objet est configuré automatiquement en fonction du schéma défini pour le DataTable par le biais de DataColumn sa collection d’objets.Such an object is automatically configured according to the schema defined for the DataTable through its collection of DataColumn objects. Après avoir créé une nouvelle ligne et défini les valeurs de chaque colonne de la ligne, ajoutez la ligne au DataRowCollection à l' Add aide de la méthode.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.

Chaque DataRow dans la collection représente une ligne de données dans la table.Each DataRow in the collection represents a row of data in the table. Pour valider une modification apportée à la valeur d’une colonne dans la ligne, vous AcceptChanges devez appeler la méthode.To commit a change to the value of a column in the row, you must invoke the AcceptChanges method.

S’applique à

Voir aussi