DataGridViewRowCollection.Insert 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將一或多個資料列插入集合中。
多載
| Insert(Int32, DataGridViewRow) |
將指定的 DataGridViewRow 插入集合。 |
| Insert(Int32, Int32) |
將指定的資料列數插入在指定位置的集合。 |
| Insert(Int32, Object[]) |
將資料列插入集合中的指定位置，並將指定物件填入儲存格。 |
Insert(Int32, DataGridViewRow)
將指定的 DataGridViewRow 插入集合。
public:
virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unitPublic Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)參數
- rowIndex
- Int32
要插入資料列的位置。
- dataGridViewRow
- DataGridViewRow
例外狀況
rowIndex 小於零或大於集合中的資料列數目。
dataGridViewRow 為 null。
關聯的 DataGridView 控制項正在執行下列其中一個動作，會暫時防止加入新的資料列：
選取控件中的所有儲存格。
清除選取範圍。
-或-
針對下列其中一個 DataGridView 事件 ，從處理常式呼叫這個方法：
-或-
DataGridView 的 DataSource 屬性不是 null。
-或-
rowIndex 等於集合中的資料列數目，且 DataGridView 的 AllowUserToAddRows 屬性設定為 true。
-或-
DataGridView 沒有資料行。
-或-
dataGridViewRow 的 DataGridView 屬性不是 null。
-或-
dataGridViewRow 的 Selected 屬性值為 true。
-或-
這項作業會在未凍結的資料列之後插入凍結的資料列，或是在凍結的資料列之前插入未凍結的資料列。
dataGridViewRow 所包含的儲存格多於控制項中的資料行數目。
備註
如果可能的話，方法 Insert(Int32, DataGridViewRow) 會將共享資料列加入至 DataGridViewRowCollection。 否則，不會共用新的數據列。 如需詳細資訊，請參閱 縮放 Windows Form DataGridView 控制項的最佳做法。
新增數據列時，控件中的數據列不會自動排序。 若要將新數據列排序為正確的位置，請在事件處理程式中DataGridView.RowsAdded呼叫 DataGridView.Sort 方法。 您也可以在事件處理程式中CellValueChanged呼叫 DataGridView.Sort 方法，以在使用者修改儲存格時排序數據列。
另請參閱
適用於
Insert(Int32, Int32)
將指定的資料列數插入在指定位置的集合。
public:
virtual void Insert(int rowIndex, int count);public virtual void Insert (int rowIndex, int count);abstract member Insert : int * int -> unit
override this.Insert : int * int -> unitPublic Overridable Sub Insert (rowIndex As Integer, count As Integer)參數
- rowIndex
- Int32
要插入資料列的位置。
- count
- Int32
要插入 DataGridViewRowCollection 的資料列數目。
例外狀況
關聯的 DataGridView 控制項正在執行下列其中一個動作，會暫時防止加入新的資料列：
選取控件中的所有儲存格。
清除選取範圍。
-或-
針對下列其中一個 DataGridView 事件 ，從處理常式呼叫這個方法：
-或-
DataGridView 的 DataSource 屬性不是 null。
-或-
DataGridView 沒有資料行。
-或-
rowIndex 等於集合中的資料列數目，且 DataGridView 的 AllowUserToAddRows 屬性設定為 true。
-或-
RowTemplate 屬性所傳回的資料列比控制項中的資料行擁有更多的儲存格。
-或-
這項作業會在未凍結的資料列之後插入凍結的資料列，或是在凍結的資料列之前插入未凍結的資料列。
備註
方法Insert(Int32, Int32)會根據 的 加入數據RowTemplateDataGridView列。 可能的話，就會共用新的數據列。 請確定屬性中指定的 RowTemplate 數據列可以共用，以獲得最佳延展性。 如需詳細資訊，請參閱 縮放 Windows Form DataGridView 控制項的最佳做法。
新增數據列時，控件中的數據列不會自動排序。 若要將新數據列排序為正確的位置，請在事件處理程式中DataGridView.RowsAdded呼叫 DataGridView.Sort 方法。 您也可以在事件處理程式中CellValueChanged呼叫 DataGridView.Sort 方法，以在使用者修改儲存格時排序數據列。
另請參閱
適用於
Insert(Int32, Object[])
將資料列插入集合中的指定位置，並將指定物件填入儲存格。
public:
virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);public virtual void Insert (int rowIndex, params object[] values);abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unitPublic Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())參數
- rowIndex
- Int32
要插入資料列的位置。
- values
- Object[]
填入新資料列儲存格的數目可變物件。
例外狀況
rowIndex 小於零或大於集合中的資料列數目。
values 為 null。
關聯的 DataGridView 控制項正在執行下列其中一個動作，會暫時防止加入新的資料列：
選取控件中的所有儲存格。
清除選取範圍。
-或-
針對下列其中一個 DataGridView 事件 ，從處理常式呼叫這個方法：
-或-
DataGridView 的 VirtualMode 屬性會設定為 true。
-或-
DataGridView 的 DataSource 屬性不是 null。
-或-
DataGridView 沒有資料行。
-或-
rowIndex 等於集合中的資料列數目，且 DataGridView 的 AllowUserToAddRows 屬性設定為 true。
-或-
控制項的 RowTemplate 屬性所傳回的資料列之 DataGridView 屬性不是 null。
-或-
這項作業會在未凍結的資料列之後插入凍結的資料列，或是在凍結的資料列之前插入未凍結的資料列。
控制項的 RowTemplate 屬性所傳回的資料列比控制項中的資料行擁有更多儲存格。
備註
方法 Insert(Int32, Object[]) 會將未共享的資料列加入至 DataGridViewRowCollection。
新增數據列時，控件中的數據列不會自動排序。 若要將新數據列排序為正確的位置，請在事件處理程式中DataGridView.RowsAdded呼叫 DataGridView.Sort 方法。 您也可以在事件處理程式中CellValueChanged呼叫 DataGridView.Sort 方法，以在使用者修改儲存格時排序數據列。
