DataGridViewRow Classe

Definição

public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))>]
type DataGridViewRow = class
    inherit DataGridViewBand

Public Class DataGridViewRow
Inherits DataGridViewBand

Herança

Object

DataGridViewElement

DataGridViewBand

DataGridViewRow

Atributos

TypeConverterAttribute

Exemplos

O exemplo de código a seguir ilustra o uso desse tipo. Este exemplo faz parte de um exemplo maior disponível em Como manipular linhas no controle Windows Forms DataGridView.

// Set row labels.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{

   int rowNumber = 1;
   System::Collections::IEnumerator^ myEnum = safe_cast<System::Collections::IEnumerable^>(dataGridView->Rows)->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataGridViewRow^ row = safe_cast<DataGridViewRow^>(myEnum->Current);
      if ( row->IsNewRow )
               continue;
      row->HeaderCell->Value = String::Format( L"Row {0}", rowNumber );

      rowNumber = rowNumber + 1;
   }

   dataGridView->AutoResizeRowHeadersWidth( DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders );
}

// Set row labels.
private void Button6_Click(object sender, System.EventArgs e)
{

    int rowNumber = 1;
    foreach (DataGridViewRow row in dataGridView.Rows)
    {
        if (row.IsNewRow) continue;
        row.HeaderCell.Value = "Row " + rowNumber;
        rowNumber = rowNumber + 1;
    }
    dataGridView.AutoResizeRowHeadersWidth(
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}

' Set row labels.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim rowNumber As Integer = 1
    For Each row As DataGridViewRow In dataGridView.Rows
        If row.IsNewRow Then Continue For
        row.HeaderCell.Value = "Row " & rowNumber
        rowNumber = rowNumber + 1
    Next
    dataGridView.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub

Comentários

A DataGridViewRow classe representa uma linha em um DataGridView controle . Você pode recuperar linhas por meio das Rows coleções e SelectedRows do controle .

Ao contrário de um DataGridViewColumn, um DataGridViewRow contém fisicamente uma coleção de todas as células nessa linha. Você pode acessar essa coleção por meio da Cells propriedade .

A DataGridViewRow classe é usada para acessar os elementos de célula individuais, bem como para ajustar a aparência e o comportamento da interface do usuário da linha, como altura e estilo de célula. Normalmente, você desejará que todas as linhas ou a maioria das linhas no controle compartilhem as mesmas características. Para definir estilos de célula para todas as linhas no controle, defina as propriedades do objeto retornado pela DataGridView.RowsDefaultCellStyle propriedade . Para definir estilos para linhas alternadas, use a DataGridView.AlternatingRowsDefaultCellStyle propriedade . Para obter mais informações sobre estilos de célula, consulte Estilos de Célula no Controle DataGridView dos Windows Forms. Você também pode usar a DataGridView.RowTemplate propriedade para definir uma linha que será usada como base para todas as linhas adicionadas ao controle.

O DataGridView controle compartilhará DataGridViewRow objetos em várias linhas de dados sempre que possível para evitar penalidades de desempenho. A menos que você esteja trabalhando com grandes quantidades de dados e enfrentando problemas de desempenho, normalmente você pode ignorar o compartilhamento de linhas. Uma linha compartilhada é indicada por um Index valor de propriedade de -1. Alguns membros da DataGridViewRow classe não podem ser usados com linhas compartilhadas, mas você pode descompartilhar uma linha acessando-a por meio da DataGridViewRowCollection.Item[] propriedade . As linhas também podem se tornar não compartilhadas de outras maneiras. Para acessar uma linha sem compartilhá-la, use o DataGridViewRowCollection.SharedRow método . Ao trabalhar com grandes quantidades de dados, você deve estar ciente de como as linhas são compartilhadas e não compartilhadas para evitar penalidades de desempenho. Para obter mais informações, consulte Práticas recomendadas para colocação em escala do controle DataGridView dos Windows Forms.

Notas aos Herdeiros

Ao derivar de DataGridViewRow e adicionar novas propriedades à classe derivada, substitua o Clone() método para copiar as novas propriedades durante as operações de clonagem. Você também deve chamar o método da Clone() classe base para que as propriedades da classe base sejam copiadas para a nova célula.

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• DataGridView
• DataGridViewColumn
• Clone()
• Práticas recomendadas para dimensionamento do controle DataGridView dos Windows Forms
• Estilos de célula no controle DataGridView dos Windows Forms