DataGridViewColumn.ReadOnly Property

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: DataGridViewColumn.cs

Source:: DataGridViewColumn.cs

Source:: DataGridViewColumn.cs

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 column's cells.

public:
 virtual property bool ReadOnly { bool get(); void set(bool value); };

public override bool ReadOnly { get; set; }

member this.ReadOnly : bool with get, set

Public Overrides Property ReadOnly As Boolean

Property Value

Boolean

true if the user cannot edit the column's cells; otherwise, false.

Exceptions

InvalidOperationException

This property is set to false for a column that is bound to a read-only data source.

Examples

The following code example demonstrates how to use the DataGridViewBand.ReadOnly property, which is nearly identical to the ReadOnly property of the DataGridViewColumn class. This code example is part of a larger example provided for the DataGridViewBand class overview.

// 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 column.

Applies to

Product	Versions
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Share via