Udostępnij za pośrednictwem


DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) Metoda

Definicja

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 -> unit
Public 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ę.

Dotyczy

Zobacz też