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