DataGridViewRowCollection.InsertCopy(Int32, Int32) 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 wiersz do kolekcji w określonej pozycji na podstawie wiersza w określonej pozycji.
public:
virtual void InsertCopy(int indexSource, int indexDestination);public virtual void InsertCopy (int indexSource, int indexDestination);abstract member InsertCopy : int * int -> unit
override this.InsertCopy : int * int -> unitPublic Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)Parametry
- indexSource
- Int32
Indeks wiersza, na którym ma być oparty nowy wiersz.
- indexDestination
- Int32
Położenie, w którym ma zostać wstawiony wiersz.
Wyjątki
indexSource jest mniejsza niż zero lub większa niż liczba wierszy w kolekcji minus jeden.
-lub-
indexDestination jest mniejsza niż zero lub większa niż liczba wierszy w kolekcji.
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-
indexDestination jest równa liczbie wierszy w kolekcji i AllowUserToAddRows jest równa true.
-lub-
Ta operacja spowoduje wstawienie zamrożonego wiersza po odrośniętych wierszach lub niezamrożonym wierszu przed zamrożonymi wierszami.
Uwagi
Ta metoda przypisuje nowy wiersz indeks określony w parametrze indexDestination i zwiększa indeksy dla wszystkich kolejnych wierszy. Właściwość InheritedStyle nowego DataGridViewRow ma te same wartości co InheritedStyleDataGridViewRow wartość pozycji na .indexSource Metoda InsertCopy dodaje wspólny wiersz do elementu DataGridViewRowCollection, jeśli to możliwe. W przeciwnym razie nowy wiersz jest nieudostępny. Aby uzyskać więcej informacji, zobacz Najlepsze rozwiązania dotyczące skalowania kontrolki Windows Forms DataGridView.
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ę.
