DataGridViewRowCollection.Insert 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將一或多個資料列插入集合中。

多載

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 -> unit

Public Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)

參數

rowIndex

Int32

要插入資料列的位置。

dataGridViewRow

DataGridViewRow

要插入 DataGridViewRowCollection 的 DataGridViewRow。

例外狀況

ArgumentOutOfRangeException

rowIndex 小於零或大於集合中的資料列數目。

ArgumentNullException

dataGridViewRow 為 null。

InvalidOperationException

關聯的 DataGridView 控制項正在執行下列其中一個動作，會暫時防止加入新的資料列：

• 選取控件中的所有儲存格。

• 清除選取範圍。

-或-

針對下列其中一個 DataGridView 事件 ，從處理常式呼叫這個方法：

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-或-

DataGridView 的 DataSource 屬性不是 null。

-或-

rowIndex 等於集合中的資料列數目，且 DataGridView 的 AllowUserToAddRows 屬性設定為 true。

-或-

DataGridView 沒有資料行。

-或-

dataGridViewRow 的 DataGridView 屬性不是 null。

-或-

dataGridViewRow 的 Selected 屬性值為 true。

-或-

這項作業會在未凍結的資料列之後插入凍結的資料列，或是在凍結的資料列之前插入未凍結的資料列。

ArgumentException

dataGridViewRow 所包含的儲存格多於控制項中的資料行數目。

備註

如果可能的話，方法 Insert(Int32, DataGridViewRow) 會將共享資料列加入至 DataGridViewRowCollection。 否則，不會共用新的數據列。 如需詳細資訊，請參閱 縮放 Windows Form DataGridView 控制項的最佳做法。

新增數據列時，控件中的數據列不會自動排序。 若要將新數據列排序為正確的位置，請在事件處理程式中DataGridView.RowsAdded呼叫 DataGridView.Sort 方法。 您也可以在事件處理程式中CellValueChanged呼叫 DataGridView.Sort 方法，以在使用者修改儲存格時排序數據列。

另請參閱

• DataGridView
• DataGridViewRow

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 -> unit

Public Overridable Sub Insert (rowIndex As Integer, count As Integer)

參數

rowIndex

Int32

要插入資料列的位置。

count

Int32

要插入 DataGridViewRowCollection 的資料列數目。

例外狀況

ArgumentOutOfRangeException

rowIndex 小於零或大於集合中的資料列數目。

-或-

count 小於 1。

InvalidOperationException

關聯的 DataGridView 控制項正在執行下列其中一個動作，會暫時防止加入新的資料列：

• 選取控件中的所有儲存格。

• 清除選取範圍。

-或-

針對下列其中一個 DataGridView 事件 ，從處理常式呼叫這個方法：

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-或-

DataGridView 的 DataSource 屬性不是 null。

-或-

DataGridView 沒有資料行。

-或-

rowIndex 等於集合中的資料列數目，且 DataGridView 的 AllowUserToAddRows 屬性設定為 true。

-或-

RowTemplate 屬性所傳回的資料列比控制項中的資料行擁有更多的儲存格。

-或-

這項作業會在未凍結的資料列之後插入凍結的資料列，或是在凍結的資料列之前插入未凍結的資料列。

備註

方法Insert(Int32, Int32)會根據 的 加入數據RowTemplateDataGridView列。 可能的話，就會共用新的數據列。 請確定屬性中指定的 RowTemplate 數據列可以共用，以獲得最佳延展性。 如需詳細資訊，請參閱 縮放 Windows Form DataGridView 控制項的最佳做法。

新增數據列時，控件中的數據列不會自動排序。 若要將新數據列排序為正確的位置，請在事件處理程式中DataGridView.RowsAdded呼叫 DataGridView.Sort 方法。 您也可以在事件處理程式中CellValueChanged呼叫 DataGridView.Sort 方法，以在使用者修改儲存格時排序數據列。

另請參閱

• DataGridView
• DataGridViewRow

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[] -> unit

Public Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())

參數

rowIndex

Int32

要插入資料列的位置。

values

Object[]

填入新資料列儲存格的數目可變物件。

例外狀況

ArgumentOutOfRangeException

rowIndex 小於零或大於集合中的資料列數目。

ArgumentNullException

values 為 null。

InvalidOperationException

關聯的 DataGridView 控制項正在執行下列其中一個動作，會暫時防止加入新的資料列：

• 選取控件中的所有儲存格。

• 清除選取範圍。

-或-

針對下列其中一個 DataGridView 事件 ，從處理常式呼叫這個方法：

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-或-

DataGridView 的 VirtualMode 屬性會設定為 true。

-或-

DataGridView 的 DataSource 屬性不是 null。

-或-

DataGridView 沒有資料行。

-或-

rowIndex 等於集合中的資料列數目，且 DataGridView 的 AllowUserToAddRows 屬性設定為 true。

-或-

控制項的 RowTemplate 屬性所傳回的資料列之 DataGridView 屬性不是 null。

-或-

這項作業會在未凍結的資料列之後插入凍結的資料列，或是在凍結的資料列之前插入未凍結的資料列。

ArgumentException

控制項的 RowTemplate 屬性所傳回的資料列比控制項中的資料行擁有更多儲存格。

備註

方法 Insert(Int32, Object[]) 會將未共享的資料列加入至 DataGridViewRowCollection。

新增數據列時，控件中的數據列不會自動排序。 若要將新數據列排序為正確的位置，請在事件處理程式中DataGridView.RowsAdded呼叫 DataGridView.Sort 方法。 您也可以在事件處理程式中CellValueChanged呼叫 DataGridView.Sort 方法，以在使用者修改儲存格時排序數據列。

另請參閱

• DataGridView
• DataGridViewRow