Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
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)

'Declaration
Public Overridable Property ReadOnly As Boolean

Property Value

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

ExceptionCondition
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 Sub Button8_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    For Each band As DataGridViewBand In dataGridView.Columns
        band.ReadOnly = True 
    Next 
End Sub

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft