DataGridViewRowCollection.AddCopies(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.
Dodaje określoną liczbę wierszy do kolekcji na podstawie wiersza w określonym indeksie.
public:
virtual int AddCopies(int indexSource, int count);
public virtual int AddCopies (int indexSource, int count);
abstract member AddCopies : int * int -> int
override this.AddCopies : int * int -> int
Public Overridable Function AddCopies (indexSource As Integer, count As Integer) As Integer
Parametry
- indexSource
- Int32
Indeks wiersza, w którym mają być oparte nowe wiersze.
- count
- Int32
Liczba wierszy do dodania do elementu DataGridViewRowCollection.
Zwraca
Indeks ostatniego dodanego wiersza.
Wyjątki
indexSource
jest mniejsza niż zero lub większa lub równa liczbie wierszy w kontrolce.
-lub-
Parametr count
ma wartość niższą niż zero.
Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, która tymczasowo uniemożliwia dodawanie nowych wierszy:
Zaznaczanie wszystkich komórek w kontrolce.
Czyszczenie zaznaczenia.
-lub-
Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:
-lub-
Właściwość DataSource obiektu DataGridView nie null
ma wartości .
-lub-
Ta operacja spowoduje dodanie zamrożonego wiersza po niezarośniętych wierszach.
Uwagi
Właściwość InheritedStyle nowego DataGridViewRow ma te same wartości co InheritedStyle właściwość elementu umieszczonego DataGridViewRow na .indexSource
Metoda AddCopies 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 Best Practices for Scaling the Windows Forms DataGridView Control (Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView).
Wiersze w kontrolce nie są automatycznie sortowane po dodaniu nowych wierszy. Aby posortować nowe wiersze w ich prawidłowej pozycji, wywołaj metodę DataGridView.Sort w procedurze obsługi zdarzeń DataGridView.RowsAdded . Można również wywołać metodę DataGridView.Sort w procedurze CellValueChanged obsługi zdarzeń, aby posortować wiersze, gdy użytkownik modyfikuje komórkę.