DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Insere uma coluna no índice fornecido na coleção.
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)Parâmetros
- columnIndex
- Int32
O índice baseado em zero no qual inserir a coluna fornecida.
- dataGridViewColumn
- DataGridViewColumn
A DataGridViewColumn inserção a ser inserida.
Exceções
dataGridViewColumn é null.
O controle associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas colunas sejam adicionadas:
Selecionando todas as células no controle.
Desmarcando a seleção.
Atualizando valores de propriedade da coluna DisplayIndex .
- ou -
Esse método está sendo chamado de um manipulador para um dos seguintes DataGridView eventos:
- ou -
dataGridViewColumn já pertence a um DataGridView controle.
- ou -
O dataGridViewColumnSortMode valor da propriedade é Automatic e o valor da SelectionMode propriedade é FullColumnSelect ou ColumnHeaderSelect. Use o controle ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() os métodos para definir temporariamente valores de propriedade conflitantes.
- ou -
O dataGridViewColumnInheritedAutoSizeMode valor da propriedade é ColumnHeader e o valor da ColumnHeadersVisible propriedade é false.
- ou -
dataGridViewColumn tem um InheritedAutoSizeMode valor de propriedade e Fill um Frozen valor de propriedade de true.
- ou -
dataGridViewColumn tem DisplayIndex e Frozen valores de propriedade que o exibiriam entre um conjunto de colunas adjacentes com o valor da propriedade oposta Frozen .
- ou -
O DataGridView controle contém pelo menos uma linha e dataGridViewColumn tem um CellType valor de propriedade de null.
Exemplos
O exemplo de código a seguir ilustra o uso desse método. Para obter mais informações, consulte How to: Add an Unbound Column to a Data-Bound Windows Forms DataGridView Control.
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
