DataGridViewRowCollection.AddCopy(Int32) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
以指定索引處的資料列為基底加入新的資料列。
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 Integer參數
- indexSource
- Int32
當成新資料列基底的資料列索引。
傳回
新資料列的索引。
例外狀況
indexSource 小於零，或大於等於集合的資料列數目。
關聯的 DataGridView 控制項正在執行下列其中一個動作，會暫時防止加入新的資料列：
選取控件中的所有儲存格。
清除選取範圍。
-或-
針對下列其中一個 DataGridView 事件 ，從處理常式呼叫這個方法：
-或-
DataGridView 的 DataSource 屬性不是 null。
-或-
這項作業會將凍結的資料列加在未凍結的資料列後面。
備註
InheritedStyle新數據列的 屬性與位於 indexSource的數據列具有相同的值InheritedStyle。 如果可能的話，此方法 AddCopy 會將共享資料列加入至 DataGridViewRowCollection。 否則，新數據列會取消共用。 如需詳細資訊，請參閱 縮放 Windows Form DataGridView 控制項的最佳做法。
加入新數據列時，控件中的數據列不會自動排序。 若要將新數據列排序成正確的位置，請在事件處理程式中DataGridView.RowsAdded呼叫 DataGridView.Sort 方法。 您也可以在事件處理程式中CellValueChanged呼叫 DataGridView.Sort 方法，以在使用者修改儲存格時排序數據列。
