DataGridViewRowCollection.AddCopy(Int32) Metoda

  • Odwołanie

Definicja

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

Dodaje nowy wiersz na podstawie wiersza w określonym indeksie.

public:
 virtual int AddCopy(int indexSource);
public virtual int AddCopy (int indexSource);
abstract member AddCopy : int -> int
override this.AddCopy : int -> int
Public Overridable Function AddCopy (indexSource As Integer) As Integer

Parametry

indexSource
Int32

Indeks wiersza, na którym ma być oparty nowy wiersz.

Zwraca

Int32

Indeks nowego wiersza.

Wyjątki

ArgumentOutOfRangeException

indexSource wartość jest mniejsza niż zero lub większa lub równa liczbie wierszy w kolekcji.

InvalidOperationException

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-

Właściwość DataSource elementu DataGridView to nie null.

-lub-

Ta operacja spowoduje dodanie zamrożonego wiersza po odłączeniu wierszy.

Uwagi

Właściwość InheritedStyle nowego wiersza ma takie same wartości jak InheritedStyle w wierszu umieszczonym na .indexSource Metoda AddCopy 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ż