DataGridViewRowCollection.InsertCopy(Int32, Int32) Metod

Definition

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.

Gäller för

Se även