DataGridViewBand.Index Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft die relative Position des Bands im DataGridView-Steuerelement ab.

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

Eigenschaftswert

Int32

Die auf 0 (null) basierende Position des Bands in der DataGridViewRowCollection oder DataGridViewColumnCollection, in der es enthalten ist. Der Standardwert ist -1 und gibt an, dass kein zugeordnetes DataGridView-Steuerelement verfügbar ist.

Attribute
BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die Index Eigenschaft verwendet, um Spaltenbeschriftungen festzulegen. Auf die Eigenschaft des Index Bandes wird über eine DataGridViewColumn.

Hinweis

Wenn visuelle Formatvorlagen aktiviert sind, überschreibt das aktuelle Design die Anzeigeformateigenschaften für Zeilen- und Spaltenüberschriften.

// 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

Hinweise

Der Wert dieser Eigenschaft entspricht nicht unbedingt der aktuellen visuellen Position des Bandes innerhalb der Auflistung. Wenn der Benutzer z. B. Spalten in einer DataGridView Laufzeit neu anordnen (vorausgesetzt, die AllowUserToOrderColumns Eigenschaft ist auf true) wird der Wert der Index Eigenschaft jeder Spalte nicht geändert. Stattdessen ändern sich die Spaltenwerte DisplayIndex . Die Sortierung von Zeilen ändert jedoch ihre Index Werte.

Gilt für

Siehe auch