DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inserisce una colonna in corrispondenza dell'indice specificato nell'insieme.
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)Parametri
- columnIndex
- Int32
Indice in base zero in corrispondenza del quale inserire la colonna specificata.
- dataGridViewColumn
- DataGridViewColumn
Oggetto DataGridViewColumn da inserire.
Eccezioni
dataGridViewColumn è null.
Il controllo associato DataGridView esegue una delle azioni seguenti che impedisce temporaneamente l'aggiunta di nuove colonne:
Selezione di tutte le celle nel controllo .
Cancellazione della selezione.
Aggiornamento dei valori delle proprietà della colonna DisplayIndex .
oppure
Questo metodo viene chiamato da un gestore per uno degli eventi seguenti DataGridView :
oppure
dataGridViewColumn appartiene già a un DataGridView controllo .
oppure
Il valore della dataGridViewColumnSortMode proprietà è Automatic e il valore della SelectionMode proprietà è FullColumnSelect o ColumnHeaderSelect. Utilizzare il controllo ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() i metodi per impostare temporaneamente i valori delle proprietà in conflitto.
oppure
Il valore della dataGridViewColumnInheritedAutoSizeMode proprietà è ColumnHeader e il valore della ColumnHeadersVisible proprietà è false.
oppure
dataGridViewColumn ha un InheritedAutoSizeMode valore della proprietà e Fill un Frozen valore della proprietà pari truea .
oppure
dataGridViewColumn ha DisplayIndex i valori delle proprietà e Frozen che lo visualizzano tra un set di colonne adiacenti con il valore della proprietà opposto Frozen .
oppure
Il DataGridView controllo contiene almeno una riga e dataGridViewColumn ha un CellType valore della proprietà .null
Esempio
Nell'esempio di codice seguente viene illustrato l'uso di questo metodo. Per altre informazioni, vedere Come aggiungere una colonna non associato a un controllo DataGridView Data-Bound Windows Forms.
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
