DataGridViewRowCollection.Insert Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> unitPublic 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
rowIndex jest mniejsza niż zero lub większa niż liczba wierszy w kolekcji.
dataGridViewRow to null.
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-
dataGridViewRowSelected 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.
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 -> unitPublic 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
rowIndex jest mniejsza niż zero lub większa niż liczba wierszy w kolekcji.
-lub-
count wartość jest mniejsza niż 1.
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[] -> unitPublic 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
rowIndex jest mniejsza niż zero lub większa niż liczba wierszy w kolekcji.
values to null.
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.
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
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla