DataGridColumnStyle.ReadOnly プロパティ

列のデータを編集できるかどうかを示す値を取得または設定します。

Public Overridable Property ReadOnly As Boolean
[C#]
public virtual bool ReadOnly {get; set;}
[C++]
public: __property virtual bool get_ReadOnly();public: __property virtual void set_ReadOnly(bool);
[JScript]
public function get ReadOnly() : Boolean;public function set ReadOnly(Boolean);

プロパティ値

データを編集できない場合は true 。それ以外の場合は false 。

解説

列に主キーが格納されている場合、またはその値が自動的に生成される場合 (DataColumn オブジェクトの AutoIncrement プロパティが true に設定されている場合) は、列を読み取り専用にします。

同様の読み取り専用のプロパティは他のクラスにも存在し、データへのアクセス制御を簡単にします。たとえば、 System.Windows.Forms.DataGrid コントロールは、その ReadOnly プロパティを使用して読み取り専用モードに設定できます。また、 DataGridTableStyle にも ReadOnly プロパティがあり、 DataColumn クラスにもデータの更新を制限するための ReadOnly プロパティがあります。

使用例

[Visual Basic, C#, C++] 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

[C#] 
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;
    }
}
 

[C++] 
private:
void SetReadOnly()
{
    DataColumnCollection* myDataColumns;
    // Get the columns for a table bound to a DataGrid.
    myDataColumns = dataSet1->Tables->Item[S"Suppliers"]->Columns;
    System::Collections::IEnumerator* myEnum = myDataColumns->GetEnumerator();
    while (myEnum->MoveNext())
    {
        DataColumn* dataColumn = __try_cast<DataColumn*>(myEnum->Current);
        dataGrid1->TableStyles->Item[0]->
            GridColumnStyles->Item[dataColumn->ColumnName]->ReadOnly = dataColumn->ReadOnly;
    }
}
 

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

DataGridColumnStyle クラス | DataGridColumnStyle メンバ | System.Windows.Forms 名前空間 | AutoIncrement | DataColumn