DataGridColumnStyle::ReadOnly Property

.NET Framework (current version)

Gets or sets a value indicating whether the data in the column can be edited.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

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

Property Value

Type: System::Boolean

true, if the data cannot be edited; otherwise, false.

Remarks

Make a column read-only if it contains a primary key or if its value is generated automatically (as when the DataColumn object's AutoIncrement property is set to true).

Similar read-only properties exist on other classes, each allowing more control over the access to data. For example, the System.Windows.Forms::DataGrid control can be set to read-only mode by using its ReadOnly property; the DataGridTableStyle also has a ReadOnly property, and the DataColumn class has a ReadOnly property for restricting data updates.

Examples

The following code example sets the DataGridColumnStyle object's ReadOnly property to the same value as the DataColumn object's ReadOnly property.

C++

void SetReadOnly()
{
   DataColumnCollection^ myDataColumns;

   // Get the columns for a table bound to a DataGrid.
   myDataColumns = dataSet1->Tables[ "Suppliers" ]->Columns;
   System::Collections::IEnumerator^ myEnum = myDataColumns->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataColumn^ dataColumn = safe_cast<DataColumn^>(myEnum->Current);
      dataGrid1->TableStyles[ 0 ]->GridColumnStyles[ dataColumn->ColumnName ]->ReadOnly = dataColumn->ReadOnly;
   }
}

Version Information

.NET Framework
Available since 1.1