DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

将某一范围的列添加到集合中。

public:
 virtual void AddRange(... cli::array <System::Windows::Forms::DataGridViewColumn ^> ^ dataGridViewColumns);

public virtual void AddRange (params System.Windows.Forms.DataGridViewColumn[] dataGridViewColumns);

abstract member AddRange : System.Windows.Forms.DataGridViewColumn[] -> unit
override this.AddRange : System.Windows.Forms.DataGridViewColumn[] -> unit

Public Overridable Sub AddRange (ParamArray dataGridViewColumns As DataGridViewColumn())

参数

dataGridViewColumns

DataGridViewColumn[]

要添加的 DataGridViewColumn 对象的数组。

例外

ArgumentNullException

dataGridViewColumns 为 null。

InvalidOperationException

关联的 DataGridView 控件正在执行以下操作之一，该操作暂时禁止添加新列：

• 选择控件中的所有单元格。

• 清除选定内容。

• 更新列 DisplayIndex 属性值。

• 或 - 正在从以下 DataGridView 事件之一的处理程序调用此方法：

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

• 或 - dataGridViewColumns 中的值至少有一个为 null。

• 或 - dataGridViewColumns 中至少有一列已属于 DataGridView 控件。

• 或 - dataGridViewColumns 中至少有一列的 CellType 属性值为 null，且 DataGridView 控件至少包含一行。

• 或 - dataGridViewColumns 中至少有一列的 SortMode 属性值为 Automatic，且 SelectionMode 属性值为 FullColumnSelect 或 ColumnHeaderSelect。 使用该控件的 ISupportInitialize.BeginInit() 和 ISupportInitialize.EndInit() 方法可暂时设置冲突的属性值。

• 或 - dataGridViewColumns 中至少有一列的 InheritedAutoSizeMode 属性值为 ColumnHeader，且 ColumnHeadersVisible 属性值为 false。

• 或 - dataGridViewColumns 中至少有一列的 InheritedAutoSizeMode 属性值为 Fill，且 Frozen 属性值为 true。

• 或 - dataGridViewColumns 中的列的 FillWeight 属性值会导致控件中所有列的组合 FillWeight 值超过 65535。

• 或 - dataGridViewColumns 中至少有两个值引用相同的 DataGridViewColumn。

• 或 - dataGridViewColumns 中至少有一列的 DisplayIndex 和 Frozen 属性值会在具有相反的 Frozen 属性值的一组相邻列中显示它。

示例

下面的代码示例演示了此方法的使用。 此示例是 How to： Set the Sizing Modes of the Windows 窗体 DataGridView 控件中提供的大型示例的一部分。

dataGridView1.Columns.AddRange(new DataGridViewTextBoxColumn[] { 
    idColumn, titleColumn, subTitleColumn, 
    summaryColumn, contentColumn });
dataGridView1.Rows.Add(new String[] { "1", 
    "A Short Title", "A Longer SubTitle", 
    "A short description of the main point.", 
    "The full contents of the topic, with detailed examples." });

dataGridView1.Columns.AddRange(New DataGridViewTextBoxColumn() { _
    idColumn, titleColumn, subTitleColumn, _
    summaryColumn, contentColumn})
dataGridView1.Rows.Add(New String() {"1", _
    "A Short Title", "A Longer SubTitle", _
    "A short description of the main point.", _
    "The full contents of the topic, with detailed examples."})

另请参阅

• DataGridView
• DataGridViewColumn