DataGridViewBand.Index Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die relative Position des Bereichs innerhalb des DataGridView Steuerelements ab.
public:
property int Index { int get(); };[System.ComponentModel.Browsable(false)]
public int Index { get; }[<System.ComponentModel.Browsable(false)>]
member this.Index : intPublic ReadOnly Property Index As IntegerEigenschaftswert
Die nullbasierte Position des Bandes im DataGridViewRowCollection oder DataGridViewColumnCollection darin enthaltenen Bereich. Der Standardwert ist -1, der angibt, dass kein zugeordnetes Steuerelement vorhanden DataGridView ist.
- Attribute
Beispiele
Im folgenden Codebeispiel wird die Index Eigenschaft zum Festlegen von Spaltenbeschriftungen verwendet. Der Zugriff auf die Eigenschaft des Bandes Index erfolgt über eine DataGridViewColumn.
Hinweis
Wenn visuelle Formatvorlagen aktiviert sind, überschreibt das aktuelle Design die Eigenschaften der Anzeigeformatvorlage 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 zur DataGridView Laufzeit neu anordnet (vorausgesetzt, die AllowUserToOrderColumns Eigenschaft ist auf festgelegt true), ändert sich der Wert der Index Eigenschaft jeder Spalte nicht. Stattdessen ändern sich die Spaltenwerte DisplayIndex . Das Sortieren von Zeilen ändert jedoch ihre Index Werte.
