La clase DataGridViewRow representa una fila de un control DataGridView. Puede recuperar filas a través de las colecciones de Rows y SelectedRows del control.

A diferencia de DataGridViewColumn, DataGridViewRow contiene físicamente una colección de todas las celdas de esa fila. Se puede obtener acceso a esta colección mediante la propiedad Cells.

La clase DataGridViewRow se utiliza para obtener acceso a cada elemento de celda, así como para ajustar la apariencia y el comportamiento de la interfaz de usuario (UI) de la fila, como el alto y el estilo de celda. Normalmente, le interesará que todas las filas del control, o la mayoría de ellas, compartan las mismas características. Para establecer los estilos de celda para todas las filas del control, establezca las propiedades del objeto que devuelve la propiedad DataGridView..::.RowsDefaultCellStyle. Para establecer los estilos de las filas alternas, utilice la propiedad DataGridView..::.AlternatingRowsDefaultCellStyle. Para obtener más información sobre los estilos de celda, vea Estilos de celda en el control DataGridView de formularios Windows Forms También se puede utilizar la propiedad DataGridView..::.RowTemplate para definir una fila que sirva de base para todas las filas que se agreguen al control.

Para evitar reducciones del rendimiento y siempre que sea posible, el control DataGridView compartirá objetos DataGridViewRow por varias filas de datos. Por lo común podrá omitir el uso compartido de filas, salvo cuando esté trabajando con cantidades grandes de datos y experimente problemas de rendimiento. Una fila compartida viene indicada por una valor -1 en la propiedad Index. Algunos miembros de la clase DataGridViewRow no se pueden utilizar con filas compartidas, pero se puede hacer que una fila deje de estar compartida obteniendo acceso a ella a través de la propiedad DataGridViewRowCollection..::.Item. También hay otras formas de hacer que las filas dejen de estar compartidas. Para obtener acceso a una fila sin que deje de estar compartida, utilice el método DataGridViewRowCollection..::.SharedRow. Cuando trabaje con grandes cantidades de datos, tenga presente cómo están compartidas o no las filas para evitar reducciones del rendimiento. Para obtener más información, vea Procedimientos recomendados para ajustar la escala del control DataGridView en formularios Windows Forms.

Cuando derive de DataGridViewRow y agregue nuevas propiedades a la clase derivada, asegúrese de reemplazar el método Clone para copiar las nuevas propiedades durante las operaciones de clonación. También debe llamar al método Clone de la clase base para que las propiedades de la clase base se copien en la nueva celda.

En el ejemplo de código siguiente se muestra el uso de este tipo. Este ejemplo forma parte de un ejemplo más extenso proporcionado en Cómo: Manipular filas en el control DataGridView de formularios Windows Forms.

' 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

// 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);
}

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework

Referencia

Otros recursos