DataGridViewRow Clase

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

En el ejemplo de código siguiente se 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 grande disponible en How para: Manipular las filas del control Windows Forms DataGridView.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

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

A diferencia de un DataGridViewColumn, un DataGridViewRow contiene físicamente 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 tener acceso a esta colección a través de la propiedad Cells.You can access this collection through the Cells property.

La clase DataGridViewRow se utiliza para tener acceso a los elementos de celda individuales, así como para ajustar la apariencia y el comportamiento de la interfaz de usuario (IU) de la fila, como el estilo de la celda y el 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, deseará que todas las filas o la mayoría de las filas del control compartan las mismas características.Typically, you will want all rows or most rows in the control to share the same characteristics. Para establecer los estilos de celda para todas las filas del control, establezca las propiedades del objeto devuelto por la propiedad DataGridView.RowsDefaultCellStyle.To set cell styles for all rows in the control, set the properties of the object returned by the DataGridView.RowsDefaultCellStyle property. Para establecer estilos para filas alternas, utilice la propiedad DataGridView.AlternatingRowsDefaultCellStyle.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 control DataGridView de Windows Forms.For more information about cell styles, see Cell Styles in the Windows Forms DataGridView Control. También puede utilizar la propiedad DataGridView.RowTemplate para definir una fila que se utilizará como base para todas las filas agregadas 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 control DataGridView compartirá DataGridViewRow objetos en varias filas de datos siempre que sea posible para evitar penalizaciones de rendimiento.The DataGridView control will share DataGridViewRow objects across multiple data rows whenever possible to avoid performance penalties. A menos que esté trabajando con grandes cantidades de datos y experimente problemas de rendimiento, normalmente puede omitir el uso compartido de filas.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 valor de propiedad Index de-1.A shared row is indicated by an Index property value of -1. Algunos miembros de la clase DataGridViewRow no se pueden utilizar con filas compartidas, pero puede dejar de compartir una fila accediendo a ella a través de la propiedad DataGridViewRowCollection.Item[Int32].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. Las filas también pueden dejar de estar compartidas de otras maneras.Rows can also become unshared in other ways. Para tener acceso a una fila sin dejar de compartirla, use el método DataGridViewRowCollection.SharedRow.To access a row without unsharing it, use the DataGridViewRowCollection.SharedRow method. Al trabajar con grandes cantidades de datos, debe tener en cuenta el modo en que se comparten y no comparten las filas para evitar penalizaciones de rendimiento.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 Procedimientos recomendados para ajustar la escala del control DataGridView en 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 invalidar el método Clone() 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 debe llamar al método Clone() de la clase base para que las propiedades de la clase base se copien 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()

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

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

Cells

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

ContextMenuStrip

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

DataBoundItem

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

DataGridView

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

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

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.

(Heredado de DataGridViewBand)
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

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

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

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

HasDefaultCellStyle

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

(Heredado de DataGridViewBand)
HeaderCell

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

HeaderCellCore

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

(Heredado de DataGridViewBand)
Height

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

Index

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

(Heredado de DataGridViewBand)
InheritedStyle

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

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

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

(Heredado de DataGridViewBand)
MinimumHeight

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

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

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

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

State

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

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.

(Heredado de DataGridViewBand)
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)

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()

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

CreateAccessibilityInstance()

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

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[])

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

CreateCellsInstance()

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

Dispose()

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

(Heredado de DataGridViewBand)
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.

(Heredado de DataGridViewBand)
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)

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

(Heredado de Object)
GetContextMenuStrip(Int32)

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

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()

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

(Heredado de Object)
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)

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

GetType()

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

(Heredado de Object)
MemberwiseClone()

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

(Heredado de Object)
OnDataGridViewChanged()

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

(Heredado de DataGridViewBand)
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)

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

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)

Genera el evento CellClick.Raises the CellClick event.

(Heredado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Genera el evento CellContentClick.Raises the CellContentClick event.

(Heredado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Genera el evento CellContentDoubleClick.Raises the CellContentDoubleClick event.

(Heredado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Genera el evento CellValueChanged.Raises the CellValueChanged event.

(Heredado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Genera el evento DataError.Raises the DataError event.

(Heredado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Genera el evento MouseWheel.Raises the MouseWheel event.

(Heredado de DataGridViewElement)
SetValues(Object[])

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

ToString()

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

Se aplica a

Consulte también: