DataGridViewBand.ReadOnly Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value indicating whether the user can edit the band's cells.
public:
virtual property bool ReadOnly { bool get(); void set(bool value); };public virtual bool ReadOnly { get; set; }member this.ReadOnly : bool with get, setPublic Overridable Property ReadOnly As BooleanProperty Value
true if the user cannot edit the band's cells; otherwise, false. The default is false.
Exceptions
When setting this property, this DataGridViewBand instance is a shared DataGridViewRow.
Examples
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 entire DataGridView read only.
void Button8_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
System::Collections::IEnumerator^ myEnum = dataGridView->Columns->GetEnumerator();
while ( myEnum->MoveNext() )
{
DataGridViewBand^ band = safe_cast<DataGridViewBand^>(myEnum->Current);
band->ReadOnly = true;
}
}
// Make the entire DataGridView read only.
private void Button8_Click(object sender, System.EventArgs e)
{
foreach (DataGridViewBand band in dataGridView.Columns)
{
band.ReadOnly = true;
}
}
' Make 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
Remarks
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.
