DataGridViewRow Clase

Definición

Representa una fila de un control 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
Herencia
Atributos

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 How to: Manipulate Rows in the Windows Forms DataGridView Control.

// 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 tener acceso 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, consulte 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 accediendo a ella a través de la DataGridViewRowCollection.Item[] propiedad . Las filas también se pueden dejar de compartir de otras maneras. Para acceder 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 comparten las filas para evitar penalizaciones de rendimiento. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en 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

DataGridViewRow()

Inicializa una nueva instancia de la clase DataGridViewRow sin utilizar una plantilla.

Propiedades

AccessibilityObject

Obtiene el objeto DataGridViewRow.DataGridViewRowAccessibleObject asignado a DataGridViewRow.

Cells

Obtiene la colección de celdas que rellenan la fila.

ContextMenuStrip

Obtiene o establece el menú contextual para la fila.

DataBoundItem

Obtiene el objeto enlazado a datos que ha rellenado la fila.

DataGridView

Obtiene el control DataGridView asociado a este elemento.

(Heredado de DataGridViewElement)
DefaultCellStyle

Obtiene o establece los estilos predeterminados para la fila, que se utilizan para representar las celdas de la fila a menos que se reemplacen los estilos.

DefaultHeaderCellType

Obtiene o establece el tipo de la celda de encabezado predeterminada en tiempo de ejecución.

(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 fila.

ErrorText

Obtiene o establece el texto del mensaje de error para los errores 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 propiedad DefaultCellStyle.

(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 control DataGridView.

(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 nuevos registros.

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 si el comportamiento se hereda de la propiedad AllowUserToResizeRows.

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 datos para asociar a la banda.

(Heredado de DataGridViewBand)
Visible

Obtiene o establece un valor que indica si la fila es visible.

Métodos

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 el control DataGridViewRow.

CreateCells(DataGridView)

Borra las celdas existentes y establece su plantilla según la plantilla DataGridView proporcionada.

CreateCells(DataGridView, Object[])

Borra las celdas existentes y establece su plantilla y valores.

CreateCellsInstance()

Construye una nueva colección de celdas basada en esta fila.

Dispose()

Libera todos los recursos que usa DataGridViewBand.

(Heredado de DataGridViewBand)
Dispose(Boolean)

Libera los recursos no administrados que usa DataGridViewBand y, de forma opcional, 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.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetContextMenuStrip(Int32)

Obtiene el menú contextual de la fila.

GetErrorText(Int32)

Obtiene el texto de error para la fila del índice especificado.

GetHashCode()

Sirve como la función hash predeterminada.

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

Calcula el alto ideal de la fila que se indica basándose en los criterios especificados.

GetState(Int32)

Devuelve un valor que indica el estado actual de la fila.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
OnDataGridViewChanged()

Se llama cuando la banda está asociada a un DataGridView diferente.

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

Dibuja la fila actual.

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

Dibuja las celdas de la fila actual.

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

Dibuja el encabezado de celda 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 inteligible que describe la fila.

Se aplica a

Consulte también