ReadOnly Property

DataGridViewBand.ReadOnly Property

 

Gets or sets a value indicating whether the user can edit the band's cells.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public virtual bool ReadOnly { get; set; }

Property Value

Type: System.Boolean

true if the user cannot edit the band's cells; otherwise, false. The default is false.

Exception Condition
InvalidOperationException

When setting this property, this DataGridViewBand instance is a shared DataGridViewRow.

The ReadOnly property affects the DataGridViewCell.ReadOnly property of each cell in the band. For example, if the ReadOnly property of a DataGridViewRow changes, then the DataGridViewCell.ReadOnly property of all cells in the row will change.

The following code example demonstrates how to use the ReadOnly property to disable editing for an entire DataGridView. This code example is part of a larger example provided for the DataGridViewBand class.

// Make the the entire DataGridView read only.
private void Button8_Click(object sender, System.EventArgs e)
{
    foreach (DataGridViewBand band in dataGridView.Columns)
    {
        band.ReadOnly = true;
    }
}

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft