DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Methode
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.
Fügt eine Spalte am angegebenen Index in der Auflistung ein.
public:
virtual void Insert(int columnIndex, System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);public virtual void Insert(int columnIndex, System.Windows.Forms.DataGridViewColumn dataGridViewColumn);abstract member Insert : int * System.Windows.Forms.DataGridViewColumn -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewColumn -> unitPublic Overridable Sub Insert (columnIndex As Integer, dataGridViewColumn As DataGridViewColumn)Parameter
- columnIndex
- Int32
Der nullbasierte Index, an dem die angegebene Spalte eingefügt werden soll.
- dataGridViewColumn
- DataGridViewColumn
Der einzufügende Text DataGridViewColumn .
Ausnahmen
dataGridViewColumn ist null.
Das zugeordnete DataGridView Steuerelement führt eine der folgenden Aktionen aus, die vorübergehend verhindern, dass neue Spalten hinzugefügt werden:
Markieren aller Zellen im Steuerelement.
Die Auswahl wird gelöscht.
Aktualisieren von Spalteneigenschaftswerten DisplayIndex .
-oder-
Diese Methode wird von einem Handler für eines der folgenden DataGridView Ereignisse aufgerufen:
-oder-
dataGridViewColumn gehört bereits zu einem DataGridView Steuerelement.
-oder-
Der dataGridViewColumnSortMode Eigenschaftswert ist Automatic und der SelectionMode Eigenschaftswert ist FullColumnSelect oder ColumnHeaderSelect. Verwenden Sie das Steuerelement ISupportInitialize.BeginInit() und ISupportInitialize.EndInit() die Methoden, um widersprüchliche Eigenschaftswerte vorübergehend festzulegen.
-oder-
Der dataGridViewColumnInheritedAutoSizeMode Eigenschaftswert ist ColumnHeader und der ColumnHeadersVisible Eigenschaftswert ist false.
-oder-
dataGridViewColumn hat einen InheritedAutoSizeMode Eigenschaftswert und Fill einen Frozen Eigenschaftswert von true.
-oder-
dataGridViewColumn hat DisplayIndex und Frozen Eigenschaftswerte, die ihn in einer Reihe angrenzender Spalten mit dem entgegengesetzten Frozen Eigenschaftswert anzeigen würden.
-oder-
Das DataGridView Steuerelement enthält mindestens eine Zeile und dataGridViewColumn hat einen CellType Eigenschaftswert von null.
Beispiele
Das folgende Codebeispiel veranschaulicht die Verwendung dieser Methode. Weitere Informationen finden Sie unter How to: Add an Unbound Column to a Data-Bound Windows Forms DataGridView Control.
private void CreateUnboundButtonColumn()
{
// Initialize the button column.
DataGridViewButtonColumn buttonColumn =
new DataGridViewButtonColumn();
buttonColumn.Name = "Details";
buttonColumn.HeaderText = "Details";
buttonColumn.Text = "View Details";
// Use the Text property for the button text for all cells rather
// than using each cell's value as the text for its own button.
buttonColumn.UseColumnTextForButtonValue = true;
// Add the button column to the control.
dataGridView1.Columns.Insert(0, buttonColumn);
}
Private Sub CreateUnboundButtonColumn()
' Initialize the button column.
Dim buttonColumn As New DataGridViewButtonColumn
With buttonColumn
.HeaderText = "Details"
.Name = "Details"
.Text = "View Details"
' Use the Text property for the button text for all cells rather
' than using each cell's value as the text for its own button.
.UseColumnTextForButtonValue = True
End With
' Add the button column to the control.
dataGridView1.Columns.Insert(0, buttonColumn)
End Sub
