DataGridViewColumnCollection.Add Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Dodaje daną kolumnę do kolekcji.
Przeciążenia
| Nazwa | Opis |
|---|---|
| Add(DataGridViewColumn) |
Dodaje daną kolumnę do kolekcji. |
| Add(String, String) |
Dodaje element DataGridViewTextBoxColumn z podaną nazwą kolumny i tekstem nagłówka kolumny do kolekcji. |
Add(DataGridViewColumn)
Dodaje daną kolumnę do kolekcji.
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 IntegerParametry
- dataGridViewColumn
- DataGridViewColumn
Element do dodania DataGridViewColumn .
Zwraca
Indeks kolumny.
Wyjątki
Parametr dataGridViewColumn ma wartość null.
Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodanie nowych kolumn:
Zaznaczanie wszystkich komórek w kontrolce.
Czyszczenie zaznaczenia.
Aktualizowanie wartości właściwości kolumny DisplayIndex .
— lub —
Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:
— lub —
dataGridViewColumn już należy do kontrolki DataGridView .
— lub —
Wartość dataGridViewColumnSortMode właściwości to Automatic , a SelectionMode wartość właściwości to FullColumnSelect lub ColumnHeaderSelect. Użyj kontrolki ISupportInitialize.BeginInit() i ISupportInitialize.EndInit() metod, aby tymczasowo ustawić wartości właściwości powodujące konflikt.
— lub —
Wartość dataGridViewColumnInheritedAutoSizeMode właściwości to ColumnHeader , a ColumnHeadersVisible wartość właściwości to false.
— lub —
dataGridViewColumn
InheritedAutoSizeMode ma wartość Fill właściwości i Frozen wartość truewłaściwości .
— lub —
dataGridViewColumn
FillWeight ma wartość właściwości, która spowoduje, że łączne FillWeight wartości wszystkich kolumn w kontrolce przekraczają 65535.
— lub —
dataGridViewColumn parametr ma DisplayIndex wartości właściwości i Frozen , które wyświetlałyby je między zestawem sąsiednich kolumn z przeciwną Frozen wartością właściwości.
— lub —
Kontrolka DataGridView zawiera co najmniej jeden wiersz i dataGridViewColumn ma CellType wartość nullwłaściwości .
Przykłady
Poniższy przykład kodu ilustruje użycie tej metody.
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
Zobacz też
Dotyczy
Add(String, String)
Dodaje element DataGridViewTextBoxColumn z podaną nazwą kolumny i tekstem nagłówka kolumny do kolekcji.
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 IntegerParametry
- columnName
- String
Nazwa, za pomocą której będzie odwoływanych kolumna.
- headerText
- String
Tekst nagłówka kolumny.
Zwraca
Indeks kolumny.
Wyjątki
Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodanie nowych kolumn:
Zaznaczanie wszystkich komórek w kontrolce.
Czyszczenie zaznaczenia.
Aktualizowanie wartości właściwości kolumny DisplayIndex .
— lub —
Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:
— lub —
Wartość SelectionMode właściwości to FullColumnSelect lub ColumnHeaderSelect, która powoduje konflikt z domyślną wartością właściwości kolumny SortModeAutomatic.
— lub —
Domyślna wartość właściwości kolumny FillWeight 100 spowoduje, że łączne FillWeight wartości wszystkich kolumn w kontrolce przekraczają 65535.
Uwagi
Parametry columnName i headerText są powiązane odpowiednio z Name właściwościami i HeaderText .
