Udostępnij za pośrednictwem


DataGridViewRowCollection.InsertCopy(Int32, Int32) Metoda

Definicja

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

Dotyczy

Zobacz też