通过

DataGridViewRowCollection.Add 方法

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

向集合中添加一行或多行。

重载

名称 说明
Add()

向集合添加新行。
Add(Int32)

将指定的新行数添加到集合中。
Add(Object[])

向集合添加新行，并使用指定的对象填充单元格。
Add(DataGridViewRow)

将指定的 DataGridViewRow 值添加到集合中。

Add()

Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs

向集合添加新行。

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 行的单元格数超过控件中的列数。

注解

重 载添加基于 的 行。 如果可能，则共享新行。 确保可以共享属性中指定的 RowTemplate 行，以获得最佳可伸缩性。 有关详细信息，请参阅 有关缩放 Windows 窗体 DataGridView 控件的最佳做法。

添加新行时，控件中的行不会自动排序。 若要将新行排序到正确的位置，请调用 DataGridView.Sort 事件处理程序中的 DataGridView.RowsAdded 方法。 你可能还想要在事件处理程序中CellValueChanged调用DataGridView.Sort该方法，以在用户修改单元格时对行进行排序。

另请参阅

适用于

Add(Int32)

Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs

将指定的新行数添加到集合中。

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 新行基于 RowTemplate 的 DataGridView。 确保可以共享属性中指定的 RowTemplate 行，以获得最佳可伸缩性。 有关详细信息，请参阅 有关缩放 Windows 窗体 DataGridView 控件的最佳做法。

添加新行时，控件中的行不会自动排序。 若要将新行排序到正确的位置，请调用 DataGridView.Sort 事件处理程序中的 DataGridView.RowsAdded 方法。 你可能还想要在事件处理程序中CellValueChanged调用DataGridView.Sort该方法，以在用户修改单元格时对行进行排序。

另请参阅

适用于

Add(Object[])

Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs

向集合添加新行，并使用指定的对象填充单元格。

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 的处理程序调用的：

-或-

VirtualMode 的 DataGridView 属性设置为 true。

-或-

DataGridView属性DataSource不是 null。

-或-

DataGridView没有列。

-或-

属性返回的 RowTemplate 行的单元格数超过控件中的列数。

-或-

此操作将在取消冻结行后添加冻结行。

注解

该方法Add(Object[])将未共享的行添加到 .DataGridViewRowCollection 有关详细信息，请参阅 有关缩放 Windows 窗体 DataGridView 控件的最佳做法。

添加新行时，控件中的行不会自动排序。 若要将新行排序到正确的位置，请调用 DataGridView.Sort 事件处理程序中的 DataGridView.RowsAdded 方法。 你可能还想要在事件处理程序中CellValueChanged调用DataGridView.Sort该方法，以在用户修改单元格时对行进行排序。

另请参阅

适用于

Add(DataGridViewRow)

Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs
Source:
DataGridViewRowCollection.cs

将指定的 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 窗体 DataGridView 控件的最佳做法。

添加新行时，控件中的行不会自动排序。 若要将新行排序到正确的位置，请调用 DataGridView.Sort 事件处理程序中的 DataGridView.RowsAdded 方法。 你可能还想要在事件处理程序中CellValueChanged调用DataGridView.Sort该方法，以在用户修改单元格时对行进行排序。

另请参阅

适用于