DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Insere uma coluna no índice indicado 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 onde inserir a coluna dada.
- dataGridViewColumn
- DataGridViewColumn
O DataGridViewColumn para inserir.
Exceções
dataGridViewColumn é null.
O controlo associado DataGridView está a realizar uma das seguintes ações que impede temporariamente a adição de novas colunas:
Selecionar todas as células no controlo.
A limpar a seleção.
Atualizar os valores das propriedades das colunas DisplayIndex .
-ou-
Este método é chamado a partir de um handler para um dos seguintes DataGridView eventos:
-ou-
dataGridViewColumn Já pertence a um DataGridView controlo.
-ou-
O dataGridViewColumnSortMode valor da propriedade é Automatic e o SelectionMode valor da propriedade é FullColumnSelect ou ColumnHeaderSelect. Use o controlo ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() os métodos para definir temporariamente valores de propriedades conflitantes.
-ou-
O dataGridViewColumnInheritedAutoSizeMode valor da propriedade é ColumnHeader e o ColumnHeadersVisible valor da propriedade é false.
-ou-
dataGridViewColumn tem um InheritedAutoSizeMode valor de propriedade de Fill e 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 de propriedade oposto Frozen .
-ou-
O DataGridView controlo contém pelo menos uma linha e dataGridViewColumn tem um CellType valor de propriedade de null.
Exemplos
O seguinte exemplo de código ilustra a utilização deste método. Para mais informações, consulte Como: Adicionar uma Coluna Não Vinculada a um Controlo 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
