Freigeben über


DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Methode

Definition

Fügt am angegebenen Index eine Spalte in die 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 -> unit
Public 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 DataGridViewColumn.

Ausnahmen

dataGridViewColumn ist null.

Das zugeordnete DataGridView-Steuerelement führt eine der folgenden Aktionen durch, die vorübergehend das Hinzufügen neuer Spalten verhindert:

  • Auswählen 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 die ISupportInitialize.BeginInit()-Methode und die ISupportInitialize.EndInit()-Methode des Steuerelements, um vorübergehend in Konflikt stehende Eigenschaftswerte festzulegen.

- oder -

Der dataGridViewColumnInheritedAutoSizeMode-Eigenschaftswert ist ColumnHeader, und der ColumnHeadersVisible-Eigenschaftswert ist false.

- oder -

dataGridViewColumn besitzt den InheritedAutoSizeMode-Eigenschaftswert Fill und den Frozen-Eigenschaftswert true.

- oder -

dataGridViewColumn besitzt einen DisplayIndex-Eigenschaftswert und einen Frozen-Eigenschaftswert, durch die sie in einer Gruppe nebeneinander liegender Spalten mit entgegengesetztem Frozen-Eigenschaftswert angezeigt wird.

- oder -

Das DataGridView-Steuerelement enthält mindestens eine Zeile, und dataGridViewColumn besitzt den CellType-Eigenschaftswert null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Methode veranschaulicht. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen einer ungebundenen Spalte zu einem Data-Bound Windows Forms DataGridView-Steuerelement.

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

Gilt für:

Weitere Informationen