DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u een kolom in de opgegeven index in de verzameling in.
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)Parameters
- columnIndex
- Int32
De index op basis van nul waarop de opgegeven kolom moet worden ingevoegd.
- dataGridViewColumn
- DataGridViewColumn
De DataGridViewColumn te invoegen.
Uitzonderingen
dataGridViewColumn is null.
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 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. Zie Hoe to: Een niet-afhankelijke kolom toevoegen aan een Data-Bound Windows Forms DataGridView-besturingselement voor meer informatie.
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
