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. 기본값은 연결된 DataGridView 컨트롤이 없음을 나타내는 -1입니다.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 런타임에 (가정 하 고는 AllowUserToOrderColumns 속성이로 설정 된 true), 값은 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.

적용 대상

추가 정보