Freigeben über


DataGridViewColumnCollection.Add Methode

Definition

Fügt der Auflistung die angegebene Spalte hinzu.

Überlädt

Add(DataGridViewColumn)

Fügt der Auflistung die angegebene Spalte hinzu.

Add(String, String)

Fügt der Auflistung eine DataGridViewTextBoxColumn mit dem angegebenen Spaltennamen und Spaltenheadertext hinzu.

Add(DataGridViewColumn)

Fügt der Auflistung die angegebene Spalte hinzu.

public:
 virtual int Add(System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);
public virtual int Add (System.Windows.Forms.DataGridViewColumn dataGridViewColumn);
abstract member Add : System.Windows.Forms.DataGridViewColumn -> int
override this.Add : System.Windows.Forms.DataGridViewColumn -> int
Public Overridable Function Add (dataGridViewColumn As DataGridViewColumn) As Integer

Parameter

dataGridViewColumn
DataGridViewColumn

Das hinzuzufügende DataGridViewColumn.

Gibt zurück

Der Index der Spalte.

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 FillWeight-Eigenschaftswert, der dazu führt, dass die FillWeight-Werte aller Spalten im Steuerelement zusammen 65535 übersteigen.

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

private DataGridView dataGridView1 = new DataGridView();

private void AddColorColumn()
{
    DataGridViewComboBoxColumn comboBoxColumn =
        new DataGridViewComboBoxColumn();
    comboBoxColumn.Items.AddRange(
        Color.Red, Color.Yellow, Color.Green, Color.Blue);
    comboBoxColumn.ValueType = typeof(Color);
    dataGridView1.Columns.Add(comboBoxColumn);
    dataGridView1.EditingControlShowing +=
        new DataGridViewEditingControlShowingEventHandler(
        dataGridView1_EditingControlShowing);
}

private void dataGridView1_EditingControlShowing(object sender,
    DataGridViewEditingControlShowingEventArgs e)
{
    ComboBox combo = e.Control as ComboBox;
    if (combo != null)
    {
        // Remove an existing event-handler, if present, to avoid 
        // adding multiple handlers when the editing control is reused.
        combo.SelectedIndexChanged -=
            new EventHandler(ComboBox_SelectedIndexChanged);

        // Add the event handler. 
        combo.SelectedIndexChanged +=
            new EventHandler(ComboBox_SelectedIndexChanged);
    }
}

private void ComboBox_SelectedIndexChanged(object sender, EventArgs e)
{
    ((ComboBox)sender).BackColor = (Color)((ComboBox)sender).SelectedItem;
}
Private WithEvents dataGridView1 As New DataGridView()

Private Sub AddColorColumn()

    Dim comboBoxColumn As New DataGridViewComboBoxColumn()
    comboBoxColumn.Items.AddRange( _
        Color.Red, Color.Yellow, Color.Green, Color.Blue)
    comboBoxColumn.ValueType = GetType(Color)
    dataGridView1.Columns.Add(comboBoxColumn)

End Sub

Private Sub dataGridView1_EditingControlShowing(ByVal sender As Object, _
    ByVal e As DataGridViewEditingControlShowingEventArgs) _
    Handles dataGridView1.EditingControlShowing

    Dim combo As ComboBox = CType(e.Control, ComboBox)
    If (combo IsNot Nothing) Then

        ' Remove an existing event-handler, if present, to avoid 
        ' adding multiple handlers when the editing control is reused.
        RemoveHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

        ' Add the event handler. 
        AddHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

    End If

End Sub

Private Sub ComboBox_SelectedIndexChanged( _
    ByVal sender As Object, ByVal e As EventArgs)

    Dim comboBox1 As ComboBox = CType(sender, ComboBox)
    comboBox1.BackColor = _
        CType(CType(sender, ComboBox).SelectedItem, Color)

End Sub

Weitere Informationen

Gilt für:

Add(String, String)

Fügt der Auflistung eine DataGridViewTextBoxColumn mit dem angegebenen Spaltennamen und Spaltenheadertext hinzu.

public:
 virtual int Add(System::String ^ columnName, System::String ^ headerText);
public virtual int Add (string columnName, string headerText);
public virtual int Add (string? columnName, string? headerText);
abstract member Add : string * string -> int
override this.Add : string * string -> int
Public Overridable Function Add (columnName As String, headerText As String) As Integer

Parameter

columnName
String

Der Name, durch den auf die Spalte verwiesen wird.

headerText
String

Der Text für den Spaltenheader.

Gibt zurück

Der Index der Spalte.

Ausnahmen

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 -

Der SelectionMode-Eigenschaftswert ist FullColumnSelect oder ColumnHeaderSelect, was zu einem Konflikt mit dem Standardspalten-SortMode-Eigenschaftswert Automatic führt.

- oder -

Der Standardspalten-FillWeight-Eigenschaftswert 100 führt dazu, dass die FillWeight-Werte aller Spalten im Steuerelement zusammen 65535 übersteigen.

Hinweise

Die columnName und headerText Parameter beziehen sich auf die Name und HeaderText Eigenschaften bzw.

Weitere Informationen

Gilt für: