DataGridViewRowCollection.Insert Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Wstawia jeden lub więcej wierszy do kolekcji.

Przeciążenia

Nazwa	Opis
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 na określonej pozycji i wypełnia komórki określonymi obiektami.

Insert(Int32, DataGridViewRow)

Źródło:

DataGridViewRowCollection.cs

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 być wstawiony wiersz.

dataGridViewRow

DataGridViewRow

Element DataGridViewRow do wstawienia do pliku DataGridViewRowCollection.

Wyjątki

ArgumentOutOfRangeException

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

ArgumentNullException

Parametr dataGridViewRow ma wartość 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.

• Czyszczenie zaznaczenia.

— lub —

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

— lub —

Właściwość DataSource obiektu DataGridView nie nullma wartości .

— lub —

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

— lub —

Kolumny DataGridView nie są kolumnami.

— lub —

Właściwość DataGridView elementu dataGridViewRow nie nullma wartości .

— lub —

dataGridViewRow Selected ma wartość truewłaściwości .

— lub —

Ta operacja spowoduje wstawienie zamrożonego wiersza po nierozroś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ółużytkowany wiersz do DataGridViewRowCollectionelementu , jeśli to możliwe. W przeciwnym razie nowy wiersz jest nieudostępniany. Aby uzyskać więcej informacji, zobacz Best Practices for Scaling the Windows Forms DataGridView Control (Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView formularzy systemu Windows).

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ż

• DataGridView
• DataGridViewRow

Insert(Int32, Int32)

Źródło:

DataGridViewRowCollection.cs

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.

• Czyszczenie zaznaczenia.

— lub —

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

— lub —

Właściwość DataSource obiektu DataGridView nie nullma wartości .

— lub —

Kolumny DataGridView nie są kolumnami.

— lub —

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

— lub —

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

— lub —

Ta operacja spowoduje wstawienie zamrożonego wiersza po nierozroś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 współużytkowany, 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 Best Practices for Scaling the Windows Forms DataGridView Control (Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView formularzy systemu Windows).

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ż

• DataGridView
• DataGridViewRow

Insert(Int32, Object[])

Źródło:

DataGridViewRowCollection.cs

Wstawia wiersz do kolekcji na 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 być 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

Parametr values ma wartość 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.

• Czyszczenie zaznaczenia.

— lub —

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

— lub —

Właściwość VirtualMode elementu DataGridView jest ustawiona na true.

— lub —

Właściwość DataSource obiektu DataGridView nie nullma wartości .

— lub —

Kolumny DataGridView nie są kolumnami.

— lub —

rowIndex jest równa liczbie wierszy w kolekcji, a AllowUserToAddRows właściwość DataGridView obiektu 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 nierozrośniętych wierszach lub niezamrożonym wierszu przed zamrożonymi wierszami.

ArgumentException

Wiersz zwracany 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ż

• DataGridView
• DataGridViewRow