DataGridViewRowCollection.AddCopies(Int32, Int32) Metoda

  • Odwołanie

Definicja

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

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

Int32

Indeks ostatniego dodanego wiersza.

Wyjątki

ArgumentOutOfRangeException

indexSource jest mniejsza niż zero lub większa lub równa liczbie wierszy w kontrolce.

-lub-

Parametr count ma wartość niższą niż zero.

InvalidOperationException

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 nullma 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ę.

Dotyczy

Zobacz też