DataGridViewBand.Index DataGridViewBand.Index DataGridViewBand.Index DataGridViewBand.Index Property

Definición

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

public:
 property int Index { int get(); };
[System.ComponentModel.Browsable(false)]
public int Index { get; }
member this.Index : int
Public ReadOnly Property Index As Integer

Valor de propiedad

La posición basada en cero de la banda en DataGridViewRowCollection o la DataGridViewColumnCollection dentro de la que está contenido.The zero-based position of the band in the DataGridViewRowCollection or DataGridViewColumnCollection that it is contained within. El valor predeterminado es -1, lo que indica que no hay ningún control DataGridView asociado.The default is -1, indicating that there is no associated DataGridView control.

Ejemplos

En el ejemplo de código siguiente Index se usa la propiedad para establecer etiquetas de columna.The following code example uses the Index property to set column labels. Se tiene acceso Index a la propiedad de la banda DataGridViewColumna través de.The band's Index property is accessed through a DataGridViewColumn.

Nota

Si los estilos visuales están habilitados, el tema actual invalida las propiedades de estilo de presentación de los encabezados de fila y de columna.If visual styles are enabled, the current theme overrides the display style properties for row and column headers.

// Style and number columns.
void Button8_Click( Object^ /*sender*/, EventArgs^ /*args*/ )
{
   DataGridViewCellStyle^ style = gcnew DataGridViewCellStyle;
   style->Alignment = DataGridViewContentAlignment::MiddleCenter;
   style->ForeColor = Color::IndianRed;
   style->BackColor = Color::Ivory;
   IEnumerator^ myEnum1 = dataGridView->Columns->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      DataGridViewColumn^ column = safe_cast<DataGridViewColumn^>(myEnum1->Current);
      column->HeaderCell->Value = column->Index.ToString();
      column->HeaderCell->Style = style;
   }
}


// Style and number columns.
private void Button8_Click(object sender,
    EventArgs args)
{
    DataGridViewCellStyle style = new DataGridViewCellStyle();
    style.Alignment =
        DataGridViewContentAlignment.MiddleCenter;
    style.ForeColor = Color.IndianRed;
    style.BackColor = Color.Ivory;

    foreach (DataGridViewColumn column in dataGridView.Columns)
    {
        column.HeaderCell.Value = column.Index.ToString();
        column.HeaderCell.Style = style;
    }
}
' Style and number columns.
Private Sub Button8_Click(ByVal sender As Object, _
    ByVal args As EventArgs) Handles Button8.Click

    Dim style As DataGridViewCellStyle = _
        New DataGridViewCellStyle()
    style.Alignment = _
        DataGridViewContentAlignment.MiddleCenter
    style.ForeColor = Color.IndianRed
    style.BackColor = Color.Ivory

    For Each column As DataGridViewColumn _
        In dataGridView.Columns

        column.HeaderCell.Value = _
            column.Index.ToString
        column.HeaderCell.Style = style
    Next
End Sub

Comentarios

El valor de esta propiedad no se corresponde necesariamente con la posición visual actual de la banda dentro de la colección.The value of this property does not necessarily correspond to the current visual position of the band within the collection. Por ejemplo, si el usuario reordena las columnas de DataGridView en tiempo de ejecución (suponiendo AllowUserToOrderColumns que la propiedad está trueestablecida en), el valor Index de la propiedad de cada columna no cambiará.For example, if the user reorders columns in a DataGridView at run time (assuming the AllowUserToOrderColumns property is set to true), the value of the Index property of each column will not change. En su lugar, los DisplayIndex valores de columna cambian.Instead, the column DisplayIndex values change. La ordenación de filas, sin embargo, Index cambia sus valores.Sorting rows, however, does change their Index values.

Se aplica a

Consulte también: