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 seguinte ilustra o uso deste tipo. Este exemplo faz parte de um exemplo maior disponível em Como: Manipular Linhas no Controlo 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

Observações

A DataGridViewRow classe representa uma linha num DataGridView controlo. Podes recuperar linhas através das Rows coleções e SelectedRows do controlo.

Ao contrário de um DataGridViewColumn, a DataGridViewRow contém fisicamente uma coleção de todas as células dessa linha. Pode aceder a esta coleção através da Cells propriedade.

A DataGridViewRow classe é usada para aceder aos elementos individuais das células, bem como para ajustar a aparência e o comportamento da interface de utilizador da linha (UI), como altura e estilo da célula. Normalmente, vai querer que todas as linhas ou a maioria das linhas no controlo partilhem as mesmas características. Para definir estilos de célula para todas as linhas no controlo, defina as propriedades do objeto devolvido 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 do Windows Forms. Também pode usar a DataGridView.RowTemplate propriedade para definir uma linha que será usada como base para todas as linhas adicionadas ao controlo.

O DataGridView controlo irá partilhar DataGridViewRow objetos em várias linhas de dados sempre que possível para evitar penalizações de desempenho. A menos que esteja a trabalhar com grandes quantidades de dados e a ter problemas de desempenho, normalmente pode ignorar a partilha de linhas. Uma linha partilhada é indicada por um Index valor de propriedade de -1. Alguns membros da DataGridViewRow classe não podem ser usados com linhas partilhadas, mas podes despartilhar uma linha ao aceder a ela através da DataGridViewRowCollection.Item[] propriedade. As linhas também podem tornar-se não partilhadas de outras formas. Para aceder a uma linha sem a deixar de partilhar, use o DataGridViewRowCollection.SharedRow método. Ao trabalhar com grandes quantidades de dados, deve estar atento a como as linhas são partilhadas e não partilhadas para evitar penalizações de desempenho. Para mais informações, consulte Boas Práticas para Escalar o Controlo Windows Forms DataGridView.

Notas para Herdeiros

Quando derivar e DataGridViewRow adicionar novas propriedades à classe derivada, certifique-se de sobrepor o Clone() método para copiar as novas propriedades durante as operações de clonagem. Deves também chamar o método da Clone() classe base para que as propriedades da classe base sejam copiadas para a nova célula.

Ver também

• DataGridView
• DataGridViewColumn
• Clone()
• Práticas recomendadas para escalonar o controlo DataGridView do Windows Forms
• Estilos de Células no Controle DataGridView do Windows Forms