DataGridViewBand.ReadOnly Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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: