DataGridViewRow Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Compartir vía