DataGridViewRowCollection.InsertCopies(Int32, 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 wiersze do kolekcji w określonej pozycji.
public:
virtual void InsertCopies(int indexSource, int indexDestination, int count);public virtual void InsertCopies (int indexSource, int indexDestination, int count);abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unitPublic Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)Parametry
- indexSource
- Int32
Indeks, DataGridViewRow na którym mają być oparte nowe wiersze.
- indexDestination
- Int32
Położenie, w którym należy wstawić wiersze.
- count
- Int32
Liczba DataGridViewRow obiektów do dodania do obiektu DataGridViewRowCollection.
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.
-lub-
count wartość jest mniejsza niż 1.
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żonych wierszy po odłączeniu wierszy lub odrożenie wierszy przed zamarzniętymi wierszami.
Uwagi
Właściwość InheritedStyle nowych DataGridViewRow obiektów ma takie same wartości jak InheritedStyleDataGridViewRow w pozycji .indexSource Metoda InsertCopies dodaje współużytkowane wiersze do elementu DataGridViewRowCollection, jeśli to możliwe. W przeciwnym razie nowe wiersze są nieudostępniane. 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ę.
