DataGridViewRowCollection.Add 方法

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

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

多載

Add()

將新資料列加入集合。
Add(Int32)

將指定數目的新資料列加入該集合。
Add(Object[])

將新的資料列加入集合中，並填入具有指定物件的儲存格。
Add(DataGridViewRow)

將指定的 DataGridViewRow 加入至集合。

Add()

將新資料列加入集合。

public:
 virtual int Add();
public virtual int Add ();
abstract member Add : unit -> int
override this.Add : unit -> int
Public Overridable Function Add () As Integer

傳回

Int32

新資料列的索引。

例外狀況

InvalidOperationException

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

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

  • 清除選取範圍。

-或-

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

-或-

DataGridView 的 DataSource 屬性不是 null。

-或-

DataGridView 沒有資料行。

-或-

這項作業會將凍結的資料列加在未凍結的資料列後面。

ArgumentException

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

備註

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

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

另請參閱

適用於

Add(Int32)

將指定數目的新資料列加入該集合。

public:
 virtual int Add(int count);
public virtual int Add (int count);
abstract member Add : int -> int
override this.Add : int -> int
Public Overridable Function Add (count As Integer) As Integer

參數

count
Int32

要加入 DataGridViewRowCollection 的資料列數目。

傳回

Int32

已加入的最後一個資料列索引。

例外狀況

ArgumentOutOfRangeException

count 小於 1。

InvalidOperationException

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

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

  • 清除選取範圍。

-或-

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

-或-

DataGridView 的 DataSource 屬性不是 null。

-或-

DataGridView 沒有資料行。

-或-

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

-或-

這項作業會將凍結的資料列加在未凍結的資料列後面。

備註

方法會將 Add(Int32) 共享資料列新增至 DataGridViewRowCollection。 新的數據列是以的 為基礎RowTemplateDataGridView。 請確定屬性中指定的 RowTemplate 數據列可以共用，以獲得最佳延展性。 如需詳細資訊，請參閱 縮放 Windows Form DataGridView 控制項的最佳做法。

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

另請參閱

適用於

Add(Object[])

將新的資料列加入集合中，並填入具有指定物件的儲存格。

public:
 virtual int Add(... cli::array <System::Object ^> ^ values);
public virtual int Add (params object[] values);
abstract member Add : obj[] -> int
override this.Add : obj[] -> int
Public Overridable Function Add (ParamArray values As Object()) As Integer

參數

values
Object[]

填入新 DataGridViewRow 的儲存格之不定數目的物件。

傳回

Int32

新資料列的索引。

例外狀況

ArgumentNullException

values 為 null。

InvalidOperationException

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

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

  • 清除選取範圍。

-或-

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

-或-

DataGridView 的 VirtualMode 屬性會設定為 true。

-或-

DataGridView 的 DataSource 屬性不是 null。

-或-

DataGridView 沒有資料行。

-或-

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

-或-

這項作業會將凍結的資料列加在未凍結的資料列後面。

備註

方法會將 Add(Object[]) 未共享的資料列加入至 DataGridViewRowCollection。 如需詳細資訊，請參閱 縮放 Windows Form DataGridView 控制項的最佳做法。

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

另請參閱

適用於

Add(DataGridViewRow)

將指定的 DataGridViewRow 加入至集合。

public:
 virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);
public virtual int Add (System.Windows.Forms.DataGridViewRow dataGridViewRow);
abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> int
Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer

參數

dataGridViewRow
DataGridViewRow

要加入至 DataGridViewRow 的 DataGridViewRowCollection。

傳回

Int32

新 DataGridViewRow 的索引。

例外狀況

InvalidOperationException

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

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

  • 清除選取範圍。

-或-

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

-或-

DataGridView 的 DataSource 屬性不是 null。

-或-

DataGridView 沒有資料行。

-或-

dataGridViewRow 的 DataGridView 屬性不是 null。

-或-

dataGridViewRow 的 Selected 屬性值為 true。

-或-

這項作業會將凍結的資料列加在未凍結的資料列後面。

ArgumentNullException

dataGridViewRow 為 null。

ArgumentException

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

備註

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

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

另請參閱

適用於