DataGridViewColumnCollection.IList.Insert(Int32, Object) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insere um elemento na coleção no índice especificado.

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;

void IList.Insert (int index, object value);

abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit

Sub Insert (index As Integer, value As Object) Implements IList.Insert

Parâmetros

index

Int32

O índice de base zero no qual o value deve ser inserido.

value

Object

O Object a ser inserido. O valor pode ser null.

Implementações

Insert(Int32, Object)

Exceções

InvalidCastException

value não é um DataGridViewColumn.

ArgumentNullException

value é null.

InvalidOperationException

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

• Selecionar todas as células no controle.

• Limpar a seleção.

• Atualizar os valores de propriedade DisplayIndex da coluna.

- ou -

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

A coluna indicada por value já pertence a um controle DataGridView.

- ou -

O valor da propriedade SortMode da coluna indicada por value é 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 InheritedAutoSizeMode da coluna indicada por value é ColumnHeader e o valor da propriedade ColumnHeadersVisible é false.

- ou -

A coluna indicada por value tem um valor da propriedade InheritedAutoSizeMode igual a Fill e um valor da propriedade Frozen igual a true.

- ou -

A coluna indicada por value tem um valor da propriedade FillWeight que fará com que os valores FillWeight combinados de todas as colunas no controle excedam 65535.

- ou -

A coluna indicada por value tem valores da propriedade DisplayIndex e Frozen que serão exibidos entre um conjunto de colunas adjacentes com o valor da propriedade Frozen oposta.

- ou -

O controle DataGridView contém pelo menos uma linha e a coluna indicada por value tem um valor da propriedade CellType de null.

Comentários

Este membro é uma implementação do membro de interface explícita. Ele só pode ser usado quando a instância de DataGridViewColumnCollection é convertida em uma interface de IList.

Confira também

• DataGridView
• DataGridViewColumn
• IList