DataGridView.RowCount, propriété
Assembly : System.Windows.Forms (dans system.windows.forms.dll)
| Type d'exception | Condition |
|---|---|
| La valeur spécifiée lors de la définition de cette propriété est inférieure à 0. - ou - La valeur spécifiée est inférieure à 1 et AllowUserToAddRows a la valeur true. | |
| Lors de la définition de cette propriété, la propriété DataSource est définie. |
Si RowCount a une valeur inférieure à la valeur actuelle, les lignes seront supprimées de la fin de la collection Rows. Si RowCount a une valeur supérieure à la valeur actuelle, les lignes seront ajoutées à la fin de la collection Rows. Les lignes supplémentaires sont basées sur la ligne spécifiée dans la propriété RowTemplate.
Si vous affectez la valeur 0 à la propriété RowCount, toutes les lignes seront supprimées du DataGridView. Cela équivaut à appeler la méthode DataGridViewRowCollection.Clear.
 Remarque |
|---|
| Si AllowUserToAddRows est true, vous ne pouvez pas attribuer la valeur 0 à RowCount. Dans ce cas, appelez la méthode DataGridViewRowCollection.Clear pour supprimer toutes les lignes, à l'exception de la ligne destinée aux nouveaux enregistrements. Dans ce cas, l'appel de Clear donne le même résultat que l'attribution de la valeur 1 à RowCount, mais s'avère beaucoup plus rapide. |
La propriété RowCount peut être utilisée avec la propriété ColumnCount pour créer un DataGridView simple pour afficher et modifier le texte. Si vous affectez une valeur supérieure à 0 à la propriété RowCount pour un contrôle DataGridView sans colonnes, un DataGridViewTextBoxColumn est automatiquement ajouté.
L'exemple de code suivant illustre l'utilisation de la propriété RowCount. Dans cet exemple, cette propriété est utilisée pour suivre le nombre d'entrées dans un DataGridView.
private void UpdateLabelText() { int WithdrawalTotal = 0; int DepositTotal = 0; int SelectedCellTotal = 0; int counter; // Iterate through all the rows and sum up the appropriate columns. for (counter = 0; counter < (DataGridView1.Rows.Count); counter++) { if (DataGridView1.Rows[counter].Cells["Withdrawals"].Value != null) { if (DataGridView1.Rows[counter]. Cells["Withdrawals"].Value.ToString().Length != 0) { WithdrawalTotal += int.Parse(DataGridView1.Rows[counter]. Cells["Withdrawals"].Value.ToString()); } } if (DataGridView1.Rows[counter].Cells["Deposits"].Value != null) { if (DataGridView1.Rows[counter] .Cells["Deposits"].Value.ToString().Length != 0) { DepositTotal += int.Parse(DataGridView1.Rows[counter] .Cells["Deposits"].Value.ToString()); } } } // Iterate through the SelectedCells collection and sum up the values. for (counter = 0; counter < (DataGridView1.SelectedCells.Count); counter++) { if (DataGridView1.SelectedCells[counter].FormattedValueType == Type.GetType("System.String")) { string value = null; // If the cell contains a value that has not been commited, // use the modified value. if (DataGridView1.IsCurrentCellDirty == true) { value = DataGridView1.SelectedCells[counter] .EditedFormattedValue.ToString(); } else { value = DataGridView1.SelectedCells[counter] .FormattedValue.ToString(); } if (value != null) { // Ignore cells in the Description column. if (DataGridView1.SelectedCells[counter].ColumnIndex != DataGridView1.Columns["Description"].Index) { if (value.Length != 0) { SelectedCellTotal += int.Parse(value); } } } } } // Set the labels to reflect the current state of the DataGridView. Label1.Text = "Withdrawals Total: " + WithdrawalTotal.ToString(); Label2.Text = "Deposits Total: " + DepositTotal.ToString(); Label3.Text = "Selected Cells Total: " + SelectedCellTotal.ToString(); Label4.Text = "Total entries: " + DataGridView1.RowCount.ToString(); }
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
