DataGridViewBand.Index プロパティ


DataGridView コントロール内のバンドの相対位置を取得します。Gets the relative position of the band within the DataGridView control.

 property int Index { int get(); };
public int Index { get; }
member this.Index : int
Public ReadOnly Property Index As Integer


格納されている DataGridViewRowCollection または DataGridViewColumnCollection 内のバンドの 0 から始まる位置。The zero-based position of the band in the DataGridViewRowCollection or DataGridViewColumnCollection that it is contained within. 既定値は -1 で、関連付けられた DataGridView コントロールがないことを示します。The default is -1, indicating that there is no associated DataGridView control.


次のコード例ではIndex 、プロパティを使用して列のラベルを設定します。The following code example uses the Index property to set column labels. バンドのIndexプロパティには、をDataGridViewColumn使用してアクセスします。The band's Index property is accessed through a DataGridViewColumn.


視覚スタイルが有効になっている場合は、現在のテーマによって、行ヘッダーおよび列ヘッダーの表示スタイルプロパティがオーバーライドされます。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 =
    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 = _
    style.ForeColor = Color.IndianRed
    style.BackColor = Color.Ivory

    For Each column As DataGridViewColumn _
        In dataGridView.Columns

        column.HeaderCell.Value = _
        column.HeaderCell.Style = style
End Sub


このプロパティの値は、必ずしもコレクション内のバンドの現在のビジュアル位置に対応しているとは限りません。The value of this property does not necessarily correspond to the current visual position of the band within the collection. たとえば、ユーザーが実行時DataGridViewに内の列を並べ替える場合 (プロパティがにtrue設定されてAllowUserToOrderColumnsいる場合)、各Index列のプロパティの値は変更されません。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. 代わりに、列DisplayIndexの値が変更されます。Instead, the column DisplayIndex values change. ただし、行の並べ替えでは、 Index値が変更されます。Sorting rows, however, does change their Index values.