DataGridView.ReadOnly Property

 

Gets or sets a value indicating whether the user can edit the cells of the DataGridView control.

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

[<BrowsableAttribute(true)>]
member ReadOnly : bool with get, set

Property Value

Type: System.Boolean

true if the user cannot edit the cells of the DataGridView control; otherwise, false. The default is false.

Exception Condition
InvalidOperationException

The specified value when setting this property is true, the current cell is in edit mode, and the current cell contains changes that cannot be committed.

Exception

The specified value when setting this property would cause the control to enter edit mode, but initialization of the editing cell value failed and either there is no handler for the DataError event or the handler has set the DataGridViewDataErrorEventArgs.ThrowException property to true. The exception object can typically be cast to type FormatException.

A cell is read-only if the value of the ReadOnly property is true for the cell, the cell's row, the cell's column, or the DataGridView.

The following code example illustrates the use of this property in a DataGridView control intended primarily for display. In this example, the visual appearance of the control is customized in several ways and the control is configured for limited interactivity. This example is part of a larger example available in the DataGridViewCellStyle class overview.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: