DataGridViewRowCollection.IList.Add(Object) Metoda

  • Odwołanie

Definicja

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

Dodaje element DataGridViewRow do kolekcji.

 virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
int IList.Add (object? value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add

Parametry

value
Object

Element Object do dodania do elementu IList.

Zwraca

Int32

Indeks nowego DataGridViewRowelementu .

Implementuje

Add(Object)

Wyjątki

InvalidCastException

value nie jest elementem DataGridViewRow.

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-

Kolumny DataGridView nie są dostępne.

-lub-

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

-lub-

valueSelected ma wartość właściwości .true

-lub-

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

ArgumentNullException

value to null.

ArgumentException

value zawiera więcej komórek niż kolumny w kontrolce.

Uwagi

Ta metoda jest jawną implementacją składową interfejsu. Można go używać tylko wtedy, gdy DataGridViewRowCollection wystąpienie jest rzutowanie do interfejsu IList .

Ta metoda wywołuje Add(DataGridViewRow) przeciążenie, przekazując value je po odlecie do elementu DataGridViewRow.

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ż