DataGridViewColumnCollection.Add 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 der Auflistung die angegebene Spalte hinzu.
Überlädt
| Name | Beschreibung |
|---|---|
| Add(DataGridViewColumn) |
Fügt der Auflistung die angegebene Spalte hinzu. |
| Add(String, String) |
Fügt der Auflistung einen DataGridViewTextBoxColumn Mit dem angegebenen Spaltennamen und dem Spaltenüberschriftentext 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 -> intPublic Overridable Function Add (dataGridViewColumn As DataGridViewColumn) As IntegerParameter
- dataGridViewColumn
- DataGridViewColumn
Der DataGridViewColumn hinzuzufügende
Gibt zurück
Der Index der Spalte.
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 einen FillWeight Eigenschaftswert, der dazu führen würde, dass die kombinierten FillWeight Werte aller Spalten im Steuerelement 65535 überschreiten.
-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.
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 einen DataGridViewTextBoxColumn Mit dem angegebenen Spaltennamen und dem Spaltenüberschriftentext 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 -> intPublic Overridable Function Add (columnName As String, headerText As String) As IntegerParameter
- columnName
- String
Der Name, nach dem die Spalte verwiesen wird.
- headerText
- String
Der Text für die Spaltenüberschrift.
Gibt zurück
Der Index der Spalte.
Ausnahmen
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-
Der SelectionMode Eigenschaftswert ist FullColumnSelect oder ColumnHeaderSelect, was mit dem Standardspalteneigenschaftswert SortMode von Automatic.
-oder-
Der Standardwert der Spalteneigenschaft FillWeight 100 würde dazu führen, dass die kombinierten FillWeight Werte aller Spalten im Steuerelement 65535 überschreiten.
Hinweise
Die columnName Parameter beziehen headerText sich auf die bzwName. die HeaderText Eigenschaften.
