DataGridViewRowCollection.IList.Insert(Int32, Object) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Wstawia element DataGridViewRow do kolekcji w określonym indeksie.

 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

Parametry

index
Int32

Liczony od elementu zerowego indeks, w którym powinien zostać wstawiony parametr value.

value
Object

Element DataGridViewRow , który ma być wstawiony do pliku DataGridViewRowCollection.

Implementuje

Insert(Int32, Object)

Wyjątki

InvalidCastException

value nie jest elementem DataGridViewRow.

ArgumentOutOfRangeException

index jest mniejsza niż zero lub większa niż liczba wierszy w kolekcji.

ArgumentNullException

value to null.

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodanie nowych wierszy:

  • Zaznaczanie wszystkich komórek w kontrolce.

  • Wyczyszczenie zaznaczenia.

-lub-

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

-lub-

Właściwość DataSource elementu DataGridView to nie null.

-lub-

index jest równa liczbie wierszy w kolekcji, a AllowUserToAddRows właściwość DataGridView jest ustawiona na truewartość .

-lub-

Kolumny DataGridView nie są dostępne.

-lub-

Właściwość DataGridView elementu value to nie null.

-lub-

valueSelected ma wartość właściwości .true

-lub-

Ta operacja spowoduje wstawienie zamrożonego wiersza po odrośniętych wierszach lub niezamrożonym wierszu przed zamrożonymi wierszami.

ArgumentException

value zawiera więcej komórek niż kolumny w kontrolce.

Uwagi

Ten element jest jawną implementacją członków. Można go używać tylko wtedy, gdy DataGridViewRowCollection wystąpienie jest rzutowanie do interfejsu IList .

Ta metoda wywołuje Insert(Int32, DataGridViewRow) przeciążenie, przekazując wartość po przekazaniu jej do elementu DataGridViewRow.

Wiersze w kontrolce nie są automatycznie sortowane po dodaniu nowych wierszy. Aby posortować nowe wiersze w prawidłowej pozycji, wywołaj metodę DataGridView.Sort w procedurze obsługi zdarzeń DataGridView.RowsAdded . Możesz również wywołać metodę DataGridView.Sort w procedurze CellValueChanged obsługi zdarzeń, aby posortować wiersze, gdy użytkownik modyfikuje komórkę.

Dotyczy

Zobacz też