DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) 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.
Wstawia kolumnę w danym indeksie w kolekcji.
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 -> unitPublic Overridable Sub Insert (columnIndex As Integer, dataGridViewColumn As DataGridViewColumn)Parametry
- columnIndex
- Int32
Indeks oparty na zera, w którym ma być wstawiona dana kolumna.
- dataGridViewColumn
- DataGridViewColumn
Element DataGridViewColumn do wstawienia.
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 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. Aby uzyskać więcej informacji, zobacz Jak dodać niezwiązaną kolumnę do kontrolki Data-Bound Windows Forms DataGridView.
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
