DataGridViewRowCollection.IList.Insert(Int32, Object) 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 um DataGridViewRow 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);
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 DataGridViewRow a ser inserido no DataGridViewRowCollection.
Implementações
Exceções
value
não é um DataGridViewRow.
index
é menor que zero ou maior que o número de linhas na coleção.
value
é null
.
O controle DataGridView associado está executando uma das seguintes ações, que impedem temporariamente que novas linhas sejam adicionadas:
Selecionar todas as células no controle.
Limpar a seleção.
- ou -
Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:
- ou -
A propriedade DataSource do DataGridView não é null
.
- ou -
index
é igual ao número de linhas na coleção e a propriedade AllowUserToAddRows do DataGridView é definida como true
.
- ou -
O DataGridView não tem colunas.
- ou -
A propriedade DataGridView do value
não é null
.
- ou -
value
tem um valor da propriedade Selected de true
.
- ou -
Essa operação poderia inserir uma linha congelada após as linhas não congeladas ou uma linha não congelada antes de linhas congeladas.
value
tem mais células do que colunas no controle.
Comentários
Este membro é uma implementação do membro de interface explícita. Ele só pode ser usado quando a instância de DataGridViewRowCollection é convertida em uma interface de IList.
Esse método chama a sobrecarga, passando o Insert(Int32, DataGridViewRow) valor após a conversão para um DataGridViewRow.
As linhas no controle não são classificadas automaticamente quando novas linhas são adicionadas. Para classificar novas linhas em sua posição correta, chame o DataGridView.Sort método em um DataGridView.RowsAdded manipulador de eventos. Talvez você também queira chamar o DataGridView.Sort método em um CellValueChanged manipulador de eventos para classificar as linhas quando o usuário modificar uma célula.
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de