DataGridViewRow Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 DataGridViewBandPublic 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. |
