Compartilhar via

DataGridViewColumnCollection.IList.Add(Object) Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Adiciona o objeto ao final da coleção.

 virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add

Parâmetros

value
Object

O Object a adicionar ao final da coleção. O valor pode ser null.

Retornos

Int32

O índice no qual o value foi adicionado.

Implementações

Add(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:

  • 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 - 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.

Aplica-se a

Confira também