Export (0) Print
Expand All

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.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft