DataGridViewRowCollection.Add 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.
Lägger till en eller flera rader i samlingen.
Överlagringar
| Name | Description |
|---|---|
| Add() |
Lägger till en ny rad i samlingen. |
| Add(Int32) |
Lägger till det angivna antalet nya rader i samlingen. |
| Add(Object[]) |
Lägger till en ny rad i samlingen och fyller cellerna med de angivna objekten. |
| Add(DataGridViewRow) |
Lägger till den angivna DataGridViewRow i samlingen. |
Add()
Lägger till en ny rad i samlingen.
public:
virtual int Add();public virtual int Add();abstract member Add : unit -> int
override this.Add : unit -> intPublic Overridable Function Add () As IntegerReturer
Indexet för den nya raden.
Undantag
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-
Den här åtgärden skulle lägga till en frusen rad efter ofrysta rader.
Raden som returneras av egenskapen RowTemplate har fler celler än det finns kolumner i kontrollen.
Kommentarer
Överlagringen Add() 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
Add(Int32)
Lägger till det angivna antalet nya rader i samlingen.
public:
virtual int Add(int count);public virtual int Add(int count);abstract member Add : int -> int
override this.Add : int -> intPublic Overridable Function Add (count As Integer) As IntegerParametrar
- count
- Int32
Antalet rader som ska läggas till i DataGridViewRowCollection.
Returer
Indexet för den sista raden som lades till.
Undantag
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-
Raden som returneras av egenskapen RowTemplate har fler celler än det finns kolumner i kontrollen.
-eller-
Den här åtgärden skulle lägga till frusna rader efter att rader som inte har frysts.
Kommentarer
Metoden Add(Int32) lägger till delade rader i DataGridViewRowCollection. De nya raderna baseras på RowTemplateDataGridView. 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
Add(Object[])
Lägger till en ny rad i samlingen och fyller cellerna med de angivna objekten.
public:
virtual int Add(... cli::array <System::Object ^> ^ values);public virtual int Add(params object[] values);abstract member Add : obj[] -> int
override this.Add : obj[] -> intPublic Overridable Function Add (ParamArray values As Object()) As IntegerParametrar
- values
- Object[]
Ett variabelt antal objekt som fyller i cellerna i den nya DataGridViewRow.
Returer
Indexet för den nya raden.
Undantag
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-
Raden som returneras av egenskapen RowTemplate har fler celler än det finns kolumner i kontrollen.
-eller-
Den här åtgärden skulle lägga till en frusen rad efter ofrysta rader.
Kommentarer
Metoden Add(Object[]) lägger till en rad som inte delas i DataGridViewRowCollection. 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
Add(DataGridViewRow)
Lägger till den angivna DataGridViewRow i samlingen.
public:
virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual int Add(System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> intPublic Overridable Function Add (dataGridViewRow As DataGridViewRow) As IntegerParametrar
- dataGridViewRow
- DataGridViewRow
Att DataGridViewRow lägga till i DataGridViewRowCollection.
Returer
Indexet för den nya DataGridViewRow.
Undantag
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-
Egenskapen DataGridView för dataGridViewRow är inte null.
-eller-
dataGridViewRow har ett Selected egenskapsvärde på true.
-eller-
Den här åtgärden skulle lägga till en frusen rad efter ofrysta rader.
dataGridViewRow är null.
dataGridViewRow har fler celler än det finns kolumner i kontrollen.
Kommentarer
Metoden Add(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
- DataGridView
- DataGridViewRow
- DataGridViewColumn
- CellTemplate
- metodtips för att skala Windows Forms DataGridView-kontrollen
