Partilhar via


DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Método

Definição

Insere uma coluna no índice especificado 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 -> unit
Public Overridable Sub Insert (columnIndex As Integer, dataGridViewColumn As DataGridViewColumn)

Parâmetros

columnIndex
Int32

O índice de base zero no qual inserir a coluna especificada.

dataGridViewColumn
DataGridViewColumn

O DataGridViewColumn a ser inserido.

Exceções

dataGridViewColumn é null.

O controle DataGridView associado está executando uma das seguintes ações, que impedem temporariamente que novas colunas sejam adicionadas:

  • Selecionando todas as células no controle.

  • Limpando a seleção.

  • Atualizando os valores de propriedade DisplayIndex da coluna.

- ou - Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:

- ou - dataGridViewColumn já pertence a um controle DataGridView.

- ou - O valor da propriedade dataGridViewColumnSortMode é Automatic e o valor da propriedade SelectionMode é FullColumnSelect ou ColumnHeaderSelect. Use os métodos ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() do controle para definir valores de propriedade conflitantes temporariamente.

- ou - O valor da propriedade dataGridViewColumnInheritedAutoSizeMode é ColumnHeader e o valor da propriedade ColumnHeadersVisible é false.

- ou - dataGridViewColumn tem um valor da propriedade InheritedAutoSizeMode de Fill e um valor da propriedade Frozen de true.

- ou - dataGridViewColumn tem valores da propriedade DisplayIndex e Frozen que serão exibidos entre um conjunto de colunas adjacentes com o valor da propriedade Frozen oposto.

- ou - O controle DataGridView contém pelo menos uma linha e dataGridViewColumn tem um valor da propriedade CellType de null.

Exemplos

O exemplo de código a seguir ilustra o uso desse método. Para obter mais informações, consulte Como adicionar uma coluna não associada a um controle 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

Aplica-se a

Confira também