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() 载添加基于 RowTemplate 的 行 DataGridView。 如果可能，将共享新行。 确保可以共享 属性中指定的 RowTemplate 行，以获得最佳可伸缩性。 有关详细信息，请参阅 缩放 Windows 窗体 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 新行基于 RowTemplate 的 DataGridView。 确保可以共享 属性中指定的 RowTemplate 行，以获得最佳可伸缩性。 有关详细信息，请参阅 缩放 Windows 窗体 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 窗体 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 具有 true 的 Selected 属性值。
- 或 -
此操作将在未冻结行之后添加一个冻结行。
dataGridViewRow 为 null。
dataGridViewRow 包含的单元格比控件中的列多。
注解
如果可能，方法Add(DataGridViewRow)将共享行添加到 。DataGridViewRowCollection 否则，新行将取消共享。 有关详细信息，请参阅 缩放 Windows 窗体 DataGridView 控件的最佳做法。
添加新行时，控件中的行不会自动排序。 若要将新行排序到正确的位置，请在事件处理程序中DataGridView.RowsAdded调用 DataGridView.Sort 方法。 你可能还希望在事件处理程序中CellValueChanged调用 DataGridView.Sort 方法，以在用户修改单元格时对行进行排序。
另请参阅
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈