DataGridViewRow.IsNewRow Property

public:
 property bool IsNewRow { bool get(); };

[System.ComponentModel.Browsable(false)]
public bool IsNewRow { get; }

[<System.ComponentModel.Browsable(false)>]
member this.IsNewRow : bool

Public ReadOnly Property IsNewRow As Boolean

Property Value

true if the row is the last row in the DataGridView, which is used for the entry of a new row of data; otherwise, false.

Attributes

BrowsableAttribute

Examples

The following code example uses the IsNewRow property to prevent attempts to set the label of the row for new records.

// Set row labels.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{

   int rowNumber = 1;
   System::Collections::IEnumerator^ myEnum = safe_cast<System::Collections::IEnumerable^>(dataGridView->Rows)->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataGridViewRow^ row = safe_cast<DataGridViewRow^>(myEnum->Current);
      if ( row->IsNewRow )
               continue;
      row->HeaderCell->Value = String::Format( L"Row {0}", rowNumber );

      rowNumber = rowNumber + 1;
   }

   dataGridView->AutoResizeRowHeadersWidth( DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders );
}

// Set row labels.
private void Button6_Click(object sender, System.EventArgs e)
{

    int rowNumber = 1;
    foreach (DataGridViewRow row in dataGridView.Rows)
    {
        if (row.IsNewRow) continue;
        row.HeaderCell.Value = "Row " + rowNumber;
        rowNumber = rowNumber + 1;
    }
    dataGridView.AutoResizeRowHeadersWidth(
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}

' Set row labels.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim rowNumber As Integer = 1
    For Each row As DataGridViewRow In dataGridView.Rows
        If row.IsNewRow Then Continue For
        row.HeaderCell.Value = "Row " & rowNumber
        rowNumber = rowNumber + 1
    Next
    dataGridView.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub

Remarks

Because the row for new records is in the Rows collection, use the IsNewRow property to determine whether a row is the row for new records or is a populated row.

A row stops being the new row when data entry into the row begins.

Applies to

See also

• DataGridView
• Using the Row for New Records in the Windows Forms DataGridView Control