DataGridViewRowCollection.InsertCopy(Int32, 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.
Infogar en rad i samlingen på den angivna positionen, baserat på raden vid angiven position.
public:
virtual void InsertCopy(int indexSource, int indexDestination);
public virtual void InsertCopy(int indexSource, int indexDestination);
abstract member InsertCopy : int * int -> unit
override this.InsertCopy : int * int -> unit
Public Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)
Parametrar
- indexSource
- Int32
Indexet för den rad som den nya raden ska baseras på.
- indexDestination
- Int32
Den position där raden ska infogas.
Undantag
indexSource är mindre än noll eller större än antalet rader i samlingen minus en.
-eller-
indexDestination är mindre än noll eller större än 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-
indexDestination är lika med antalet rader i samlingen och AllowUserToAddRows är true.
-eller-
Den här åtgärden infogar en frusen rad efter avfrysta rader eller en avfryst rad före frysta rader.
Kommentarer
Den här metoden tilldelar den nya raden som indexet angav i parametern indexDestination och ökar indexen för alla efterföljande rader. Egenskapen InheritedStyle för den nya DataGridViewRow har samma värden som för InheritedStyle den DataGridViewRow positionerade på indexSource. Metoden InsertCopy 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.