Share via


DataGridColumnStyle.ReadOnly 属性

获取或设置一个值,该值指示该列中的数据是否可以编辑。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms(在 system.windows.forms.dll 中)

语法

声明
Public Overridable Property ReadOnly As Boolean
用法
Dim instance As DataGridColumnStyle
Dim value As Boolean

value = instance.ReadOnly

instance.ReadOnly = value
public virtual bool ReadOnly { get; set; }
public:
virtual property bool ReadOnly {
    bool get ();
    void set (bool value);
}
/** @property */
public boolean get_ReadOnly ()

/** @property */
public void set_ReadOnly (boolean value)
public function get ReadOnly () : boolean

public function set ReadOnly (value : boolean)

属性值

如果数据不能编辑,则为 true;否则为 false

备注

当某列包含主键或其值是自动生成的时(与 DataColumn 对象的 AutoIncrement 属性设置为 true 时一样),请使该列成为只读列。

其他类中存在类似的只读属性,每个这类属性都允许对数据访问进行更多的控制。例如,可以通过使用 System.Windows.Forms.DataGrid 控件的 ReadOnly 属性将该控件设置为只读模式;DataGridTableStyle 也具有 ReadOnly 属性,并且 DataColumn 类具有用于限制数据更新的 ReadOnly 属性。

示例

下面的代码示例将 DataGridColumnStyle 对象的 ReadOnly 属性的值设置为与 DataColumn 对象的 ReadOnly 属性的值相同。

Private Sub SetReadOnly()
    Dim myColumn As DataGridColumnStyle
    Dim myDataColumns As DataColumnCollection
    ' Get the columns for a table bound to a DataGrid.
    myDataColumns = dataSet1.Tables("Suppliers").Columns
    Dim dataColumn As DataColumn
    For Each dataColumn In myDataColumns
        dataGrid1.TableStyles(0).GridColumnStyles(dataColumn.ColumnName).ReadOnly = dataColumn.ReadOnly
    Next dataColumn
End Sub 'SetReadOnly
private void SetReadOnly()
{
    DataColumnCollection myDataColumns;
    // Get the columns for a table bound to a DataGrid.
    myDataColumns = dataSet1.Tables["Suppliers"].Columns;
    foreach(DataColumn dataColumn in myDataColumns)
    {
        dataGrid1.TableStyles[0].GridColumnStyles[dataColumn.ColumnName].ReadOnly = dataColumn.ReadOnly;
    }
}
 
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;
   }
}
private void SetReadOnly()
{
    DataColumnCollection myDataColumns;
    // Get the columns for a table bound to a DataGrid.
    myDataColumns = dataSet1.get_Tables().get_Item("Suppliers").
        get_Columns();
    DataColumn dataColumn;
    for (int iCtr = 0; iCtr < myDataColumns.get_Count(); iCtr++) {
        dataColumn = myDataColumns.get_Item(iCtr);
        dataGrid1.get_TableStyles().get_Item(0).get_GridColumnStyles().
            get_Item(dataColumn.get_ColumnName()).
            set_ReadOnly(dataColumn.get_ReadOnly());
    }
} //SetReadOnly

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

请参见

参考

DataGridColumnStyle 类
DataGridColumnStyle 成员
System.Windows.Forms 命名空间
AutoIncrement
DataColumn