DataGridViewRow.ReadOnly Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gets or sets a value indicating whether the row is read-only.

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

[System.ComponentModel.Browsable(true)]
public override bool ReadOnly { get; set; }

[<System.ComponentModel.Browsable(true)>]
member this.ReadOnly : bool with get, set

Public Overrides Property ReadOnly As Boolean

Property Value

Boolean

true if the row is read-only; otherwise, false.

Attributes

BrowsableAttribute

Exceptions

InvalidOperationException

The row is in a DataGridView control and is a shared row.

Examples

The following code example demonstrates how to use the DataGridViewBand.ReadOnly property, which is nearly identical to the ReadOnly property of the DataGridViewRow class. 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 row.

Setting this property has no effect if the value of the DataGridView.ReadOnly property is true.

See also

• DataGridView
• ReadOnly
• Best Practices for Scaling the Windows Forms DataGridView Control