DataGridViewRowCollection.AddCopy(Int32) 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 ny rad baserat på raden i det angivna indexet.
public:
virtual int AddCopy(int indexSource);public virtual int AddCopy(int indexSource);abstract member AddCopy : int -> int
override this.AddCopy : int -> intPublic Overridable Function AddCopy (indexSource As Integer) As IntegerParametrar
- indexSource
- Int32
Indexet för den rad som den nya raden ska baseras på.
Returer
Indexet för den nya raden.
Undantag
indexSource är mindre än noll eller större än eller lika med antalet rader i samlingen.
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-
Den här åtgärden skulle lägga till en frusen rad efter ofrysta rader.
Kommentarer
Egenskapen InheritedStyle för den nya raden har samma värden som för InheritedStyle raden som är placerad på indexSource. Metoden AddCopy 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.
