Udostępnij za pośrednictwem

DataGridViewRowCollection.Insert Metoda

  • Odwołanie

Definicja

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

Wstawia co najmniej jeden wiersz do kolekcji.

Przeciążenia

Insert(Int32, DataGridViewRow)

Wstawia określony DataGridViewRow element do kolekcji.
Insert(Int32, Int32)

Wstawia określoną liczbę wierszy do kolekcji w określonej lokalizacji.
Insert(Int32, Object[])

Wstawia wiersz do kolekcji w określonej pozycji i wypełnia komórki określonymi obiektami.

Insert(Int32, DataGridViewRow)

Wstawia określony DataGridViewRow element do kolekcji.

public:
 virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);
public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);
abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unit
Public Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)

Parametry

rowIndex
Int32

Położenie, w którym ma zostać wstawiony wiersz.

dataGridViewRow
DataGridViewRow

Element DataGridViewRow , który ma być wstawiony do pliku DataGridViewRowCollection.

Wyjątki

ArgumentOutOfRangeException

rowIndex jest mniejsza niż zero lub większa niż liczba wierszy w kolekcji.

ArgumentNullException

dataGridViewRow to null.

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-

rowIndex jest równa liczbie wierszy w kolekcji, a AllowUserToAddRows właściwość DataGridView jest ustawiona na truewartość .

-lub-

Kolumny DataGridView nie są dostępne.

-lub-

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

-lub-

dataGridViewRow Selected ma wartość właściwości .true

-lub-

Ta operacja spowoduje wstawienie zamrożonego wiersza po odrośniętych wierszach lub niezamrożonym wierszu przed zamrożonymi wierszami.

ArgumentException

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

Uwagi

Metoda Insert(Int32, DataGridViewRow) 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ę.

Zobacz też

Dotyczy

Insert(Int32, Int32)

Wstawia określoną liczbę wierszy do kolekcji w określonej lokalizacji.

public:
 virtual void Insert(int rowIndex, int count);
public virtual void Insert (int rowIndex, int count);
abstract member Insert : int * int -> unit
override this.Insert : int * int -> unit
Public Overridable Sub Insert (rowIndex As Integer, count As Integer)

Parametry

rowIndex
Int32

Położenie, w którym należy wstawić wiersze.

count
Int32

Liczba wierszy do wstawienia do obiektu DataGridViewRowCollection.

Wyjątki

ArgumentOutOfRangeException

rowIndex jest mniejsza niż zero lub większa niż liczba wierszy w kolekcji.

-lub-

count wartość jest mniejsza niż 1.

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-

rowIndex jest równa liczbie wierszy w kolekcji, a AllowUserToAddRows właściwość DataGridView jest ustawiona na truewartość .

-lub-

Wiersz zwrócony przez RowTemplate właściwość ma więcej komórek niż kolumny w kontrolce.

-lub-

Ta operacja spowoduje wstawienie zamrożonego wiersza po odrośniętych wierszach lub niezamrożonym wierszu przed zamrożonymi wierszami.

Uwagi

Metoda Insert(Int32, Int32) dodaje wiersze oparte na RowTemplate obiekcie DataGridView. Nowy wiersz jest udostępniany, jeśli to możliwe. Upewnij się, że wiersz określony we RowTemplate właściwości może być współużytkowany w celu uzyskania najlepszej skalowalności. 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ę.

Zobacz też

Dotyczy

Insert(Int32, Object[])

Wstawia wiersz do kolekcji w określonej pozycji i wypełnia komórki określonymi obiektami.

public:
 virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);
public virtual void Insert (int rowIndex, params object[] values);
abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unit
Public Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())

Parametry

rowIndex
Int32

Położenie, w którym ma zostać wstawiony wiersz.

values
Object[]

Zmienna liczba obiektów, które wypełniają komórki nowego wiersza.

Wyjątki

ArgumentOutOfRangeException

rowIndex jest mniejsza niż zero lub większa niż liczba wierszy w kolekcji.

ArgumentNullException

values to null.

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ść DataGridView jest ustawiona VirtualMode na truewartość .

-lub-

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

-lub-

Kolumny DataGridView nie są dostępne.

-lub-

rowIndex jest równa liczbie wierszy w kolekcji, a AllowUserToAddRows właściwość DataGridView jest ustawiona na truewartość .

-lub-

Właściwość DataGridView wiersza zwróconego przez właściwość kontrolki RowTemplate nie nulljest .

-lub-

Ta operacja spowoduje wstawienie zamrożonego wiersza po odrośniętych wierszach lub niezamrożonym wierszu przed zamrożonymi wierszami.

ArgumentException

Wiersz zwrócony przez właściwość kontrolki RowTemplate ma więcej komórek niż kolumny w kontrolce.

Uwagi

Metoda Insert(Int32, Object[]) dodaje nieudostępny wiersz do elementu DataGridViewRowCollection.

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

Zobacz też

Dotyczy