DataGridViewBand.ReadOnly Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica se o usuário pode editar as células da banda.

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

Valor da propriedade

Boolean

true se o usuário não puder editar as células da banda; caso contrário, false. O padrão é false.

Exceções

InvalidOperationException

Ao configurar essa propriedade, essa instância DataGridViewBand é uma DataGridViewRow compartilhada.

Exemplos

O exemplo de código a seguir demonstra como usar a ReadOnly propriedade para desabilitar a edição de um inteiro DataGridView. Este exemplo de código faz parte de um exemplo maior fornecido para a DataGridViewBand classe .

// 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

Comentários

A ReadOnly propriedade afeta a DataGridViewCell.ReadOnly propriedade de cada célula na banda. Por exemplo, se a ReadOnly propriedade de um DataGridViewRow for alterada, a DataGridViewCell.ReadOnly propriedade de todas as células na linha será alterada.

Confira também

• DataGridViewElementStates
• DataGridView
• DataGridViewRow
• DataGridViewColumn
• DataGridViewCell
• ReadOnly