¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
DataGridViewRow (Clase)
Collapse the table of content
Expand the table of content

DataGridViewRow (Clase)

Representa una fila de un control DataGridView.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

[TypeConverterAttribute(typeof(DataGridViewRowConverter))] 
public class DataGridViewRow : DataGridViewBand
/** @attribute TypeConverterAttribute(System.Windows.Forms.DataGridViewRowConverter) */ 
public class DataGridViewRow extends DataGridViewBand
TypeConverterAttribute(System.Windows.Forms.DataGridViewRowConverter) 
public class DataGridViewRow extends DataGridViewBand
No aplicable.

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.

Notas para los herederos: 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 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);
}

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar:
© 2015 Microsoft