DataGridViewRowCollection.IList.Insert(Int32, Object) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Wyjątki
value
nie jest elementem DataGridViewRow.
index
jest mniejsza niż zero lub większa niż liczba wierszy w kolekcji.
value
to null
.
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 true
wartość .
-lub-
Kolumny DataGridView nie są dostępne.
-lub-
Właściwość DataGridView elementu value
to nie null
.
-lub-
value
Selected 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.
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ż
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla