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)

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

Property Value

Type: System::Boolean

true if the user cannot edit the band's cells; otherwise, false. The default is false.

Exception Condition
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.
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;
   }
}


.NET Framework
Available since 2.0
Return to top
Show: