DataGridViewRowCollection.Insert Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Infogar en eller flera rader i samlingen.
Överlagringar
| Name | Description |
|---|---|
| Insert(Int32, DataGridViewRow) |
Infogar den angivna DataGridViewRow i samlingen. |
| Insert(Int32, Int32) |
Infogar det angivna antalet rader i samlingen på den angivna platsen. |
| Insert(Int32, Object[]) |
Infogar en rad i samlingen på den angivna positionen och fyller cellerna med de angivna objekten. |
Insert(Int32, DataGridViewRow)
Infogar den angivna DataGridViewRow i samlingen.
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)
Parametrar
- rowIndex
- Int32
Den position där raden ska infogas.
- dataGridViewRow
- DataGridViewRow
Infoga DataGridViewRow i DataGridViewRowCollection.
Undantag
rowIndex är mindre än noll eller större än antalet rader i samlingen.
dataGridViewRow är null.
Den associerade DataGridView kontrollen utför någon av följande åtgärder som tillfälligt förhindrar att nya rader läggs till:
Markera alla celler i kontrollen.
Rensa markeringen.
-eller-
Den här metoden anropas från en hanterare för någon av följande DataGridView händelser:
-eller-
Egenskapen DataSource för DataGridView är inte null.
-eller-
rowIndex är lika med antalet rader i samlingen och AllowUserToAddRows egenskapen för DataGridView är inställd på true.
-eller-
Har DataGridView inga kolumner.
-eller-
Egenskapen DataGridViewdataGridViewRow för är inte null.
-eller-
dataGridViewRow har ett Selected egenskapsvärde på true.
-eller-
Den här åtgärden infogar en frusen rad efter avfrysta rader eller en avfryst rad före frysta rader.
dataGridViewRow har fler celler än det finns kolumner i kontrollen.
Kommentarer
Metoden Insert(Int32, DataGridViewRow) lägger till en delad rad i DataGridViewRowCollection, om möjligt. I annat fall tas den nya raden bort från delningen. Mer information finns i Best Practices for Scaling the Windows Forms DataGridView Control.
Rader i kontrollen sorteras inte automatiskt när nya rader läggs till. Om du vill sortera nya rader i rätt position anropar du DataGridView.Sort metoden i en DataGridView.RowsAdded händelsehanterare. Du kanske också vill anropa DataGridView.Sort metoden i en CellValueChanged händelsehanterare för att sortera raderna när användaren ändrar en cell.
Se även
Gäller för
Insert(Int32, Int32)
Infogar det angivna antalet rader i samlingen på den angivna platsen.
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)
Parametrar
- rowIndex
- Int32
Den position där raderna ska infogas.
- count
- Int32
Antalet rader som ska infogas DataGridViewRowCollectioni .
Undantag
rowIndex är mindre än noll eller större än antalet rader i samlingen.
-eller-
count är mindre än 1.
Den associerade DataGridView kontrollen utför någon av följande åtgärder som tillfälligt förhindrar att nya rader läggs till:
Markera alla celler i kontrollen.
Rensa markeringen.
-eller-
Den här metoden anropas från en hanterare för någon av följande DataGridView händelser:
-eller-
Egenskapen DataSource för DataGridView är inte null.
-eller-
Har DataGridView inga kolumner.
-eller-
rowIndex är lika med antalet rader i samlingen och AllowUserToAddRows egenskapen för DataGridView är inställd på true.
-eller-
Raden som returneras av egenskapen RowTemplate har fler celler än det finns kolumner i kontrollen.
-eller-
Den här åtgärden infogar en frusen rad efter avfrysta rader eller en avfryst rad före frysta rader.
Kommentarer
Metoden Insert(Int32, Int32) lägger till rader som baseras på RowTemplate .DataGridView Den nya raden delas om möjligt. Se till att raden som anges i RowTemplate egenskapen kan delas för bästa skalbarhet. Mer information finns i Best Practices for Scaling the Windows Forms DataGridView Control.
Rader i kontrollen sorteras inte automatiskt när nya rader läggs till. Om du vill sortera nya rader i rätt position anropar du DataGridView.Sort metoden i en DataGridView.RowsAdded händelsehanterare. Du kanske också vill anropa DataGridView.Sort metoden i en CellValueChanged händelsehanterare för att sortera raderna när användaren ändrar en cell.
Se även
Gäller för
Insert(Int32, Object[])
Infogar en rad i samlingen på den angivna positionen och fyller cellerna med de angivna objekten.
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())
Parametrar
- rowIndex
- Int32
Den position där raden ska infogas.
- values
- Object[]
Ett variabelt antal objekt som fyller cellerna i den nya raden.
Undantag
rowIndex är mindre än noll eller större än antalet rader i samlingen.
values är null.
Den associerade DataGridView kontrollen utför någon av följande åtgärder som tillfälligt förhindrar att nya rader läggs till:
Markera alla celler i kontrollen.
Rensa markeringen.
-eller-
Den här metoden anropas från en hanterare för någon av följande DataGridView händelser:
-eller-
Egenskapen VirtualMode för DataGridView är inställd på true.
-eller-
Egenskapen DataSource för DataGridView är inte null.
-eller-
Har DataGridView inga kolumner.
-eller-
rowIndex är lika med antalet rader i samlingen och AllowUserToAddRows egenskapen för DataGridView är inställd på true.
-eller-
Egenskapen DataGridView för raden som returneras av kontrollens RowTemplate egenskap är inte null.
-eller-
Den här åtgärden infogar en frusen rad efter avfrysta rader eller en avfryst rad före frysta rader.
Raden som returneras av kontrollens RowTemplate egenskap har fler celler än det finns kolumner i kontrollen.
Kommentarer
Metoden Insert(Int32, Object[]) lägger till en rad som inte delas i DataGridViewRowCollection.
Rader i kontrollen sorteras inte automatiskt när nya rader läggs till. Om du vill sortera nya rader i rätt position anropar du DataGridView.Sort metoden i en DataGridView.RowsAdded händelsehanterare. Du kanske också vill anropa DataGridView.Sort metoden i en CellValueChanged händelsehanterare för att sortera raderna när användaren ändrar en cell.