Export (0) Print
Expand All

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:
virtual property bool ReadOnly {
	bool get ();
	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.

ExceptionCondition
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

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft