DataGridViewColumnCollection.Add Methode

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Hiermee voegt u de opgegeven kolom toe aan de verzameling.

Overloads

Name Description
Add(DataGridViewColumn)

Hiermee voegt u de opgegeven kolom toe aan de verzameling.
Add(String, String)

Voegt een DataGridViewTextBoxColumn met de opgegeven kolomnaam en kolomkoptekst toe aan de verzameling.

Add(DataGridViewColumn)

Hiermee voegt u de opgegeven kolom toe aan de verzameling.

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

Parameters

dataGridViewColumn
DataGridViewColumn

De DataGridViewColumn te toevoegen.

Retouren

Int32

De index van de kolom.

Uitzonderingen

ArgumentNullException

dataGridViewColumn is null.

InvalidOperationException

Het bijbehorende DataGridView besturingselement voert een van de volgende acties uit waarmee tijdelijk wordt voorkomen dat nieuwe kolommen worden toegevoegd:

  • Alle cellen in het besturingselement selecteren.

  • De selectie wissen.

  • DisplayIndex Kolomeigenschapswaarden bijwerken.

– of –

Deze methode wordt aangeroepen vanuit een handler voor een van de volgende DataGridView gebeurtenissen:

– of –

dataGridViewColumn behoort al tot een DataGridView besturingselement.

– of –

De dataGridViewColumnSortMode eigenschapswaarde is Automatic en de SelectionMode eigenschapswaarde is FullColumnSelect of ColumnHeaderSelect. Gebruik het besturingselement ISupportInitialize.BeginInit() en ISupportInitialize.EndInit() de methoden om tijdelijk conflicterende eigenschapswaarden in te stellen.

– of –

De dataGridViewColumnInheritedAutoSizeMode eigenschapswaarde is ColumnHeader en de ColumnHeadersVisible eigenschapswaarde is false.

– of –

dataGridViewColumn heeft een InheritedAutoSizeMode eigenschapswaarde van Fill en een Frozen eigenschapswaarde van true.

– of –

dataGridViewColumn heeft een FillWeight eigenschapswaarde die ertoe zou leiden dat de gecombineerde FillWeight waarden van alle kolommen in het besturingselement groter zijn dan 65535.

– of –

dataGridViewColumn heeft DisplayIndex en Frozen eigenschapswaarden die deze weergeven tussen een set aangrenzende kolommen met de tegenovergestelde Frozen eigenschapswaarde.

– of –

Het DataGridView besturingselement bevat ten minste één rij en dataGridViewColumn heeft een CellType eigenschapswaarde van null.

Voorbeelden

Het volgende codevoorbeeld illustreert het gebruik van deze methode.

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

Zie ook

Van toepassing op

Add(String, String)

Voegt een DataGridViewTextBoxColumn met de opgegeven kolomnaam en kolomkoptekst toe aan de verzameling.

public:
 virtual int Add(System::String ^ columnName, System::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

Parameters

columnName
String

De naam waarmee de kolom wordt verwezen.

headerText
String

De tekst voor de koptekst van de kolom.

Retouren

Int32

De index van de kolom.

Uitzonderingen

InvalidOperationException

Het bijbehorende DataGridView besturingselement voert een van de volgende acties uit waarmee tijdelijk wordt voorkomen dat nieuwe kolommen worden toegevoegd:

  • Alle cellen in het besturingselement selecteren.

  • De selectie wissen.

  • DisplayIndex Kolomeigenschapswaarden bijwerken.

– of –

Deze methode wordt aangeroepen vanuit een handler voor een van de volgende DataGridView gebeurtenissen:

– of –

De SelectionMode eigenschapswaarde is FullColumnSelect of ColumnHeaderSelect, die conflicteert met de standaardkolomeigenschapswaarde SortMode van Automatic.

– of –

De standaardwaarde van de kolomeigenschap FillWeight van 100 zorgt ervoor dat de gecombineerde FillWeight waarden van alle kolommen in het besturingselement groter zijn dan 65535.

Opmerkingen

De columnName parameters headerText zijn respectievelijk gerelateerd aan de Name en HeaderText eigenschappen.

Zie ook

Van toepassing op