DataGridViewRow Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

DataGridViewRow.cs

Representa una fila de un DataGridView control .

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

Herencia

Object

DataGridViewElement

DataGridViewBand

DataGridViewRow

Atributos

TypeConverterAttribute

Ejemplos

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

// 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

Comentarios

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

A diferencia de , DataGridViewColumnun DataGridViewRow objeto contiene físicamente una colección de todas las celdas de esa fila. Puede acceder a esta colección a través de la Cells propiedad .

La DataGridViewRow clase se usa para acceder a los elementos de celda individuales, así como para ajustar la apariencia y el comportamiento de la interfaz de usuario de fila (UI), como el alto y el estilo de celda. Normalmente, querrá que todas las filas o la mayoría de las filas del control compartan las mismas características. Para establecer estilos de celda para todas las filas del control, establezca las propiedades del objeto devuelto por la DataGridView.RowsDefaultCellStyle propiedad . Para establecer estilos para filas alternas, use la DataGridView.AlternatingRowsDefaultCellStyle propiedad . 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 puede usar la DataGridView.RowTemplate propiedad para definir una fila que se usará como base para todas las filas agregadas al control.

El DataGridView control compartirá DataGridViewRow objetos en varias filas de datos siempre que sea posible para evitar penalizaciones de rendimiento. A menos que trabaje con grandes cantidades de datos y experimente problemas de rendimiento, normalmente puede omitir el uso compartido de filas. Una fila compartida se indica mediante un Index valor de propiedad de -1. Algunos miembros de la DataGridViewRow clase no se pueden usar con filas compartidas, pero puede dejar de compartir una fila accediéndolo a través de la DataGridViewRowCollection.Item[] propiedad . Las filas también se pueden dejar de compartir de otras maneras. Para tener acceso a una fila sin deshacer su uso compartido, use el DataGridViewRowCollection.SharedRow método . Al trabajar con grandes cantidades de datos, debe tener en cuenta cómo se comparten y no se comparten las filas para evitar penalizaciones de rendimiento. Para obtener más información, vea Procedimientos recomendados para escalar el control DataGridView de formularios Windows Forms.

Notas a los desarrolladores de herederos

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

Constructores

Nombre	Description
DataGridViewRow()	Inicializa una nueva instancia de la DataGridViewRow clase sin usar una plantilla.

Propiedades

Nombre	Description
AccessibilityObject	Obtiene el DataGridViewRow.DataGridViewRowAccessibleObject objeto asignado a .DataGridViewRow
Cells	Obtiene la colección de celdas que rellenan la fila.
ContextMenuStrip	Obtiene o establece el menú contextual de la fila.
DataBoundItem	Obtiene el objeto enlazado a datos que rellena la fila.
DataGridView	Obtiene el DataGridView control asociado a este elemento. (Heredado de DataGridViewElement)
DefaultCellStyle	Obtiene o establece los estilos predeterminados de la fila, que se usan para representar las celdas de la fila a menos que se invaliden los estilos.
DefaultHeaderCellType	Obtiene o establece el tipo en tiempo de ejecución de la celda de encabezado predeterminada. (Heredado de DataGridViewBand)
Displayed	Obtiene un valor que indica si esta fila se muestra en la pantalla.
DividerHeight	Obtiene o establece el alto, en píxeles, del divisor de filas.
ErrorText	Obtiene o establece el texto del mensaje de error para los errores de nivel de fila.
Frozen	Obtiene o establece un valor que indica si la fila está inmovilizada.
HasDefaultCellStyle	Obtiene un valor que indica si se ha establecido la DefaultCellStyle propiedad . (Heredado de DataGridViewBand)
HeaderCell	Obtiene o establece la celda de encabezado de la fila.
HeaderCellCore	Obtiene o establece la celda de encabezado de .DataGridViewBand (Heredado de DataGridViewBand)
Height	Obtiene o establece el alto actual de la fila.
Index	Obtiene la posición relativa de la banda dentro del DataGridView control. (Heredado de DataGridViewBand)
InheritedStyle	Obtiene el estilo de celda en vigor para la fila.
IsNewRow	Obtiene un valor que indica si la fila es la fila de registros nuevos.
IsRow	Obtiene un valor que indica si la banda representa una fila. (Heredado de DataGridViewBand)
MinimumHeight	Obtiene o establece el alto mínimo de la fila.
ReadOnly	Obtiene o establece un valor que indica si la fila es de solo lectura.
Resizable	Obtiene o establece un valor que indica si los usuarios pueden cambiar el tamaño de la fila o indicar que el comportamiento se hereda de la AllowUserToResizeRows propiedad .
Selected	Obtiene o establece un valor que indica si la fila está seleccionada.
State	Obtiene el estado actual de la fila.
Tag	Obtiene o establece el objeto que contiene los datos que se van a asociar a la banda. (Heredado de DataGridViewBand)
Visible	Obtiene o establece un valor que indica si la fila está visible.

Métodos

Nombre	Description
AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifica un estilo de borde de encabezado de fila de entrada según los criterios especificados.
Clone()	Crea una copia exacta de esta fila.
CreateAccessibilityInstance()	Crea un nuevo objeto accesible para .DataGridViewRow
CreateCells(DataGridView, Object[])	Borra las celdas existentes y establece sus valores y plantilla.
CreateCells(DataGridView)	Borra las celdas existentes y establece su plantilla según la plantilla proporcionada DataGridView .
CreateCellsInstance()	Construye una nueva colección de celdas basada en esta fila.
Dispose()	Libera todos los recursos usados por .DataGridViewBand (Heredado de DataGridViewBand)
Dispose(Boolean)	Libera los recursos no administrados usados por el DataGridViewBand y, opcionalmente, libera los recursos administrados. (Heredado de DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)	Dibuja un rectángulo de foco alrededor de los límites especificados.
GetContextMenuStrip(Int32)	Obtiene el menú contextual de la fila.
GetErrorText(Int32)	Obtiene el texto de error de la fila en el índice especificado.
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)	Calcula el alto ideal de la fila especificada en función de los criterios especificados.
GetState(Int32)	Devuelve un valor que indica el estado actual de la fila.
OnDataGridViewChanged()	Se llama cuando la banda está asociada a otro DataGridView. (Heredado de DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)	Pinta la fila actual.
PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Pinta las celdas de la fila actual.
PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Pinta la celda de encabezado de la fila actual.
RaiseCellClick(DataGridViewCellEventArgs)	Genera el evento CellClick. (Heredado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Genera el evento CellContentClick. (Heredado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Genera el evento CellContentDoubleClick. (Heredado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Genera el evento CellValueChanged. (Heredado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Genera el evento DataError. (Heredado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Genera el evento MouseWheel. (Heredado de DataGridViewElement)
SetValues(Object[])	Establece los valores de las celdas de la fila.
ToString()	Obtiene una cadena legible que describe la fila.

Consulte también

• DataGridView
• DataGridViewColumn
• Clone()
• Procedimientos recomendados para escalar el control DataGridView de formularios Windows Forms
• Estilos de celda en el control DataGridView de formularios Windows Forms