DataGridViewBand.ReadOnly DataGridViewBand.ReadOnly DataGridViewBand.ReadOnly DataGridViewBand.ReadOnly Property

定義

取得或設定值,指出使用者是否可以編輯群組列的儲存格。Gets or sets a value indicating whether the user can edit the band's cells.

public:
 virtual property bool ReadOnly { bool get(); void set(bool value); };
public virtual bool ReadOnly { get; set; }
member this.ReadOnly : bool with get, set
Public Overridable Property ReadOnly As Boolean

屬性值

如果使用者不能編輯群組列的儲存格,則為 true,否則為 falsetrue if the user cannot edit the band's cells; otherwise, false. 預設為 falseThe default is false.

例外狀況

當設定這個屬性時,這個 DataGridViewBand 執行個體會是共用的 DataGridViewRowWhen setting this property, this DataGridViewBand instance is a shared DataGridViewRow.

範例

下列程式碼範例示範如何使用ReadOnly屬性來停用整個DataGridView的編輯。The following code example demonstrates how to use the ReadOnly property to disable editing for an entire DataGridView. 這個程式碼範例是針對DataGridViewBand類別提供之較大範例的一部分。This code example is part of a larger example provided for the DataGridViewBand class.

// Make 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;
   }
}


// Make the entire DataGridView read only.
private void Button8_Click(object sender, System.EventArgs e)
{
    foreach (DataGridViewBand band in dataGridView.Columns)
    {
        band.ReadOnly = true;
    }
}
' Make the entire DataGridView read only.
Private Sub Button8_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    For Each band As DataGridViewBand In dataGridView.Columns
        band.ReadOnly = True
    Next
End Sub

備註

屬性會影響寬線中每個資料格的屬性。DataGridViewCell.ReadOnly ReadOnlyThe ReadOnly property affects the DataGridViewCell.ReadOnly property of each cell in the band. 例如, 如果ReadOnly的屬性DataGridViewRow變更, 則資料列中所有DataGridViewCell.ReadOnly資料格的屬性都會變更。For example, if the ReadOnly property of a DataGridViewRow changes, then the DataGridViewCell.ReadOnly property of all cells in the row will change.

適用於

另請參閱