Partilhar via


DataGridViewRow Classe

Definição

Representa uma linha em um controle DataGridView.

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
Atributos

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

DataGridViewRow()

Inicializa uma nova instância da classe DataGridViewRow sem usar um modelo.

Propriedades

AccessibilityObject

Obtém o DataGridViewRow.DataGridViewRowAccessibleObject atribuído ao DataGridViewRow.

Cells

Obtém a coleção de células que populam a linha.

ContextMenuStrip

Obtém ou define o menu de atalho da linha.

DataBoundItem

Obtém o objeto com associação de dados que populou a linha.

DataGridView

Obtém o controle de DataGridView associado a esse elemento.

(Herdado de DataGridViewElement)
DefaultCellStyle

Obtém ou define os estilos padrão para a linha, que são usados para renderizar células na linha, a menos que os estilos sejam substituídos.

DefaultHeaderCellType

Obtém ou define o tipo de tempo de execução da célula de cabeçalho padrão.

(Herdado de DataGridViewBand)
Displayed

Obtém um valor que indica se esta linha é exibida na tela.

DividerHeight

Obtém ou define a altura, em pixels, do divisor de linhas.

ErrorText

Obtém ou define o texto da mensagem de erro para erros no nível de linha.

Frozen

Obtém ou define um valor que indica se a linha está congelada.

HasDefaultCellStyle

Obtém um valor que indica se a propriedade DefaultCellStyle foi definida.

(Herdado de DataGridViewBand)
HeaderCell

Obtém ou define a célula de cabeçalho da linha.

HeaderCellCore

Obtém ou define a célula de cabeçalho do DataGridViewBand.

(Herdado de DataGridViewBand)
Height

Obtém ou define a altura da linha atual.

Index

Obtém a posição relativa da faixa dentro do controle DataGridView.

(Herdado de DataGridViewBand)
InheritedStyle

Obtém o estilo de célula em vigor para a linha.

IsNewRow

Obtém um valor que indica se a linha é a linha para novos registros.

IsRow

Obtém um valor que indica se a banda representa uma linha.

(Herdado de DataGridViewBand)
MinimumHeight

Obtém ou define a altura mínima da linha.

ReadOnly

Obtém ou define um valor que indica se a linha é somente leitura.

Resizable

Obtém ou define um valor que indica se os usuários podem redimensionar a linha ou se o comportamento é herdado da propriedade AllowUserToResizeRows.

Selected

Obtém ou define um valor que indica se a linha está selecionada.

State

Obtém o estado atual da linha.

Tag

Obtém ou define o objeto que contém os dados associados à banda.

(Herdado de DataGridViewBand)
Visible

Obtém ou define um valor que indica se a linha está visível.

Métodos

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

Modifica um estilo de borda do cabeçalho de linha de entrada de acordo com os critérios especificados.

Clone()

Cria uma cópia exata desta linha.

CreateAccessibilityInstance()

Cria um novo objeto acessível para o DataGridViewRow.

CreateCells(DataGridView)

Limpa as células existentes e define seu modelo de acordo com o modelo DataGridView fornecido.

CreateCells(DataGridView, Object[])

Limpa as células existentes e define seus valores e modelo.

CreateCellsInstance()

Constrói uma nova coleção de células baseada nessa linha.

Dispose()

Libera todos os recursos usados pelo DataGridViewBand.

(Herdado de DataGridViewBand)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo DataGridViewBand e opcionalmente libera os recursos gerenciados.

(Herdado de DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

Desenha o retângulo de foco em volta dos limites especificados.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetContextMenuStrip(Int32)

Obtém o menu de atalho para a linha.

GetErrorText(Int32)

Obtém o texto de erro para a linha no índice especificado.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)

Calcula a altura ideal da linha especificada com base nos critérios indicados.

GetState(Int32)

Retorna um valor que indica o estado atual da linha.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
OnDataGridViewChanged()

Chamado quando a faixa está associada a um DataGridView diferente.

(Herdado de DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

Pinta a linha atual.

PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

Pinta as células na linha atual.

PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

Pinta a célula de cabeçalho da linha atual.

RaiseCellClick(DataGridViewCellEventArgs)

Aciona o evento CellClick.

(Herdado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Aciona o evento CellContentClick.

(Herdado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Aciona o evento CellContentDoubleClick.

(Herdado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Aciona o evento CellValueChanged.

(Herdado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Aciona o evento DataError.

(Herdado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Aciona o evento MouseWheel.

(Herdado de DataGridViewElement)
SetValues(Object[])

Define os valores das células da linha.

ToString()

Obtém uma cadeia de caracteres legível que descreve a linha.

Aplica-se a

Confira também