DataGridViewRow DataGridViewRow DataGridViewRow DataGridViewRow Class

Definición

Representa una fila de un control DataGridView.Represents a row in a 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
type DataGridViewRow = class
    inherit DataGridViewBand
Public Class DataGridViewRow
Inherits DataGridViewBand
Herencia
Atributos

Ejemplos

El ejemplo de código siguiente muestra el uso de este tipo.The following code example illustrates the use of this type. Este ejemplo forma parte de un ejemplo más extenso proporcionado en Cómo: Manipular filas en el Control DataGridView de Windows Forms.This example is part of a larger example available in 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

El DataGridViewRow clase representa una fila en un DataGridView control.The DataGridViewRow class represents a row in a DataGridView control. Puede recuperar las filas a través del Rows y SelectedRows colecciones del control.You can retrieve rows through the Rows and SelectedRows collections of the control.

A diferencia de un DataGridViewColumn, un DataGridViewRow físicamente contiene una colección de todas las celdas de esa fila.Unlike a DataGridViewColumn, a DataGridViewRow physically contains a collection of all of the cells in that row. Puede obtener acceso a esta colección a través de la Cells propiedad.You can access this collection through the Cells property.

La DataGridViewRow clase se utiliza para tener acceso a los elementos de la celda individual, así como para ajustar la apariencia y comportamiento de la interfaz de usuario (IU), fila como el estilo de celda y de alto.The DataGridViewRow class is used to access the individual cell elements, as well as to adjust the appearance and behavior of the row user interface (UI), such as height and cell style. Normalmente, le interesará todas las filas o la mayoría comparten las mismas características del control.Typically, you will want all rows or most rows in the control to share the same characteristics. Para establecer estilos de celda para todas las filas en el control, establezca las propiedades del objeto devuelto por la DataGridView.RowsDefaultCellStyle propiedad.To set cell styles for all rows in the control, set the properties of the object returned by the DataGridView.RowsDefaultCellStyle property. Para establecer los estilos para las filas alternas, utilice el DataGridView.AlternatingRowsDefaultCellStyle propiedad.To set styles for alternating rows, use the DataGridView.AlternatingRowsDefaultCellStyle property. Para obtener más información sobre los estilos de celda, vea estilos de celda en el DataGridView Control de Windows Forms.For more information about cell styles, see Cell Styles in the Windows Forms DataGridView Control. También puede usar el DataGridView.RowTemplate propiedad para definir una fila que se usará como base para todas las filas que se agrega al control.You can also use the DataGridView.RowTemplate property to define a row that will be used as a basis for all rows added to the control.

El DataGridView control compartirán DataGridViewRow objetos en varias filas de datos siempre que sea posible para evitar las penalizaciones de rendimiento.The DataGridView control will share DataGridViewRow objects across multiple data rows whenever possible to avoid performance penalties. A menos que se trabaja con grandes cantidades de datos y está experimentando problemas de rendimiento, normalmente puede pasar por alto el uso compartido de la fila.Unless you are working with large amounts of data and experiencing performance issues, you can typically ignore row sharing. Una fila compartida se indica mediante un Index valor de propiedad de -1.A shared row is indicated by an Index property value of -1. Algunos miembros de la DataGridViewRow clase no se puede usar con filas compartidas, pero se puede dejar de compartir una fila para acceder a ellos a través de la DataGridViewRowCollection.Item[Int32] propiedad.Some members of the DataGridViewRow class cannot be used with shared rows, but you can unshare a row by accessing it through the DataGridViewRowCollection.Item[Int32] property. Filas también pueden estar compartidas de otras maneras.Rows can also become unshared in other ways. Para tener acceso a una fila sin que deje de estar compartida, use el DataGridViewRowCollection.SharedRow método.To access a row without unsharing it, use the DataGridViewRowCollection.SharedRow method. Cuando se trabaja con grandes cantidades de datos, debe tener en cuenta cómo se comparte y uso no compartidas para evitar las penalizaciones de rendimiento filas.When working with large amounts of data, you should be aware of how rows are shared and unshared to avoid performance penalties. Para obtener más información, consulte mejores prácticas para escalar el DataGridView Control de Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Notas a los desarrolladores de herederos

Al derivar de DataGridViewRow y agregar nuevas propiedades a la clase derivada, asegúrese de reemplazar el Clone() método para copiar las nuevas propiedades durante las operaciones de clonación.When you derive from DataGridViewRow and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. También se debe llamar a la clase base Clone() método para que las propiedades de la clase base se copian en la nueva celda.You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

Constructores

DataGridViewRow() DataGridViewRow() DataGridViewRow() DataGridViewRow()

Inicializa una nueva instancia de la clase DataGridViewRow sin utilizar una plantilla.Initializes a new instance of the DataGridViewRow class without using a template.

Propiedades

AccessibilityObject AccessibilityObject AccessibilityObject AccessibilityObject

Obtiene el objeto DataGridViewRow.DataGridViewRowAccessibleObject asignado a DataGridViewRow.Gets the DataGridViewRow.DataGridViewRowAccessibleObject assigned to the DataGridViewRow.

Cells Cells Cells Cells

Obtiene la colección de celdas que rellenan la fila.Gets the collection of cells that populate the row.

ContextMenuStrip ContextMenuStrip ContextMenuStrip ContextMenuStrip

Obtiene o establece el menú contextual para la fila.Gets or sets the shortcut menu for the row.

DataBoundItem DataBoundItem DataBoundItem DataBoundItem

Obtiene el objeto enlazado a datos que ha rellenado la fila.Gets the data-bound object that populated the row.

DataGridView DataGridView DataGridView DataGridView

Obtiene el control DataGridView asociado a este elemento.Gets the DataGridView control associated with this element.

(Inherited from DataGridViewElement)
DefaultCellStyle DefaultCellStyle DefaultCellStyle 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.Gets or sets the default styles for the row, which are used to render cells in the row unless the styles are overridden.

DefaultHeaderCellType DefaultHeaderCellType DefaultHeaderCellType DefaultHeaderCellType

Obtiene o establece el tipo de la celda de encabezado predeterminada en tiempo de ejecución.Gets or sets the run-time type of the default header cell.

(Inherited from DataGridViewBand)
Displayed Displayed Displayed Displayed

Obtiene un valor que indica si esta fila se muestra en la pantalla.Gets a value indicating whether this row is displayed on the screen.

DividerHeight DividerHeight DividerHeight DividerHeight

Obtiene o establece el alto, en píxeles, del divisor de fila.Gets or sets the height, in pixels, of the row divider.

ErrorText ErrorText ErrorText ErrorText

Obtiene o establece el texto del mensaje de error para los errores de fila.Gets or sets the error message text for row-level errors.

Frozen Frozen Frozen Frozen

Obtiene o establece un valor que indica si la fila está inmovilizada.Gets or sets a value indicating whether the row is frozen.

HasDefaultCellStyle HasDefaultCellStyle HasDefaultCellStyle HasDefaultCellStyle

Obtiene un valor que indica si se ha establecido la propiedad DefaultCellStyle.Gets a value indicating whether the DefaultCellStyle property has been set.

(Inherited from DataGridViewBand)
HeaderCell HeaderCell HeaderCell HeaderCell

Obtiene o establece la celda de encabezado de la fila.Gets or sets the row's header cell.

HeaderCellCore HeaderCellCore HeaderCellCore HeaderCellCore

Obtiene o establece la celda de encabezado de DataGridViewBand.Gets or sets the header cell of the DataGridViewBand.

(Inherited from DataGridViewBand)
Height Height Height Height

Obtiene o establece el alto actual de la fila.Gets or sets the current height of the row.

Index Index Index Index

Obtiene la posición relativa de la banda dentro del control DataGridView.Gets the relative position of the band within the DataGridView control.

(Inherited from DataGridViewBand)
InheritedStyle InheritedStyle InheritedStyle InheritedStyle

Obtiene el estilo de celda en vigor para la fila.Gets the cell style in effect for the row.

IsNewRow IsNewRow IsNewRow IsNewRow

Obtiene un valor que indica si la fila es la fila de nuevos registros.Gets a value indicating whether the row is the row for new records.

IsRow IsRow IsRow IsRow

Obtiene un valor que indica si la banda representa una fila.Gets a value indicating whether the band represents a row.

(Inherited from DataGridViewBand)
MinimumHeight MinimumHeight MinimumHeight MinimumHeight

Obtiene o establece el alto mínimo de la fila.Gets or sets the minimum height of the row.

ReadOnly ReadOnly ReadOnly ReadOnly

Obtiene o establece un valor que indica si la fila es de sólo lectura.Gets or sets a value indicating whether the row is read-only.

Resizable Resizable Resizable 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.Gets or sets a value indicating whether users can resize the row or indicating that the behavior is inherited from the AllowUserToResizeRows property.

Selected Selected Selected Selected

Obtiene o establece un valor que indica si la fila está seleccionada.Gets or sets a value indicating whether the row is selected.

State State State State

Obtiene el estado actual de la fila.Gets the current state of the row.

Tag Tag Tag Tag

Obtiene o establece el objeto que contiene datos para asociar a la banda.Gets or sets the object that contains data to associate with the band.

(Inherited from DataGridViewBand)
Visible Visible Visible Visible

Obtiene o establece un valor que indica si la fila es visible.Gets or sets a value indicating whether the row is visible.

Métodos

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean) AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean) AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean) AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

Modifica un estilo de borde de encabezado de fila de entrada según los criterios especificados.Modifies an input row header border style according to the specified criteria.

Clone() Clone() Clone() Clone()

Crea una copia exacta de esta fila.Creates an exact copy of this row.

CreateAccessibilityInstance() CreateAccessibilityInstance() CreateAccessibilityInstance() CreateAccessibilityInstance()

Crea un nuevo objeto accesible para el control DataGridViewRow.Creates a new accessible object for the DataGridViewRow.

CreateCells(DataGridView) CreateCells(DataGridView) CreateCells(DataGridView) CreateCells(DataGridView)

Borra las celdas existentes y establece su plantilla según la plantilla DataGridView proporcionada.Clears the existing cells and sets their template according to the supplied DataGridView template.

CreateCells(DataGridView, Object[]) CreateCells(DataGridView, Object[]) CreateCells(DataGridView, Object[]) CreateCells(DataGridView, Object[])

Borra las celdas existentes y establece su plantilla y valores.Clears the existing cells and sets their template and values.

CreateCellsInstance() CreateCellsInstance() CreateCellsInstance() CreateCellsInstance()

Construye una nueva colección de celdas basada en esta fila.Constructs a new collection of cells based on this row.

Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos que usa DataGridViewBand.Releases all resources used by the DataGridViewBand.

(Inherited from DataGridViewBand)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos no administrados que usa DataGridViewBand y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources.

(Inherited from DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean) DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean) DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean) DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

Dibuja un rectángulo de foco alrededor de los límites especificados.Draws a focus rectangle around the specified bounds.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetContextMenuStrip(Int32) GetContextMenuStrip(Int32) GetContextMenuStrip(Int32) GetContextMenuStrip(Int32)

Obtiene el menú contextual para la fila.Gets the shortcut menu for the row.

GetErrorText(Int32) GetErrorText(Int32) GetErrorText(Int32) GetErrorText(Int32)

Obtiene el texto de error para la fila del índice especificado.Gets the error text for the row at the specified index.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean) GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean) GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean) GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)

Calcula el alto ideal de la fila que se indica basándose en los criterios especificados.Calculates the ideal height of the specified row based on the specified criteria.

GetState(Int32) GetState(Int32) GetState(Int32) GetState(Int32)

Devuelve un valor que indica el estado actual de la fila.Returns a value indicating the current state of the row.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnDataGridViewChanged() OnDataGridViewChanged() OnDataGridViewChanged() OnDataGridViewChanged()

Se llama cuando la banda está asociada a un DataGridView diferente.Called when the band is associated with a different DataGridView.

(Inherited from DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean) Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean) Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean) Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

Dibuja la fila actual.Paints the current row.

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

Dibuja las celdas de la fila actual.Paints the cells in the current row.

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

Dibuja el encabezado de celda de la fila actual.Paints the header cell of the current row.

RaiseCellClick(DataGridViewCellEventArgs) RaiseCellClick(DataGridViewCellEventArgs) RaiseCellClick(DataGridViewCellEventArgs) RaiseCellClick(DataGridViewCellEventArgs)

Genera el evento CellClick.Raises the CellClick event.

(Inherited from DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs) RaiseCellContentClick(DataGridViewCellEventArgs) RaiseCellContentClick(DataGridViewCellEventArgs) RaiseCellContentClick(DataGridViewCellEventArgs)

Genera el evento CellContentClick.Raises the CellContentClick event.

(Inherited from DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs) RaiseCellContentDoubleClick(DataGridViewCellEventArgs) RaiseCellContentDoubleClick(DataGridViewCellEventArgs) RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Genera el evento CellContentDoubleClick.Raises the CellContentDoubleClick event.

(Inherited from DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs) RaiseCellValueChanged(DataGridViewCellEventArgs) RaiseCellValueChanged(DataGridViewCellEventArgs) RaiseCellValueChanged(DataGridViewCellEventArgs)

Genera el evento CellValueChanged.Raises the CellValueChanged event.

(Inherited from DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs) RaiseDataError(DataGridViewDataErrorEventArgs) RaiseDataError(DataGridViewDataErrorEventArgs) RaiseDataError(DataGridViewDataErrorEventArgs)

Genera el evento DataError.Raises the DataError event.

(Inherited from DataGridViewElement)
RaiseMouseWheel(MouseEventArgs) RaiseMouseWheel(MouseEventArgs) RaiseMouseWheel(MouseEventArgs) RaiseMouseWheel(MouseEventArgs)

Genera el evento MouseWheel.Raises the MouseWheel event.

(Inherited from DataGridViewElement)
SetValues(Object[]) SetValues(Object[]) SetValues(Object[]) SetValues(Object[])

Establece los valores de las celdas de la fila.Sets the values of the row's cells.

ToString() ToString() ToString() ToString()

Obtiene una cadena inteligible que describe la fila.Gets a human-readable string that describes the row.

Se aplica a

Consulte también: