DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
向集合中添加一系列列。
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[] -> unitPublic Overridable Sub AddRange (ParamArray dataGridViewColumns As DataGridViewColumn())参数
- dataGridViewColumns
- DataGridViewColumn[]
要添加的对象数组 DataGridViewColumn 。
例外
dataGridViewColumns 是 null。
关联的 DataGridView 控件正在执行下列操作之一，暂时阻止添加新列：
选择控件中的所有单元格。
清除所选内容。
更新列 DisplayIndex 属性值。
-或-
此方法是从以下事件之一 DataGridView 的处理程序调用的：
-或-
中dataGridViewColumns至少有一个值。null
-或-
至少有一个列 dataGridViewColumns 已属于控件 DataGridView 。
-或-
至少有一列 dataGridViewColumns 具有 CellType 属性值 null ，并且 DataGridView 控件至少包含一行。
-或-
至少有一列具有属性值，dataGridViewColumns并且属性值为SortMode或 Automatic。SelectionModeFullColumnSelectColumnHeaderSelect 使用控件 ISupportInitialize.BeginInit() 和 ISupportInitialize.EndInit() 方法暂时设置冲突的属性值。
-或-
至少有一列 dataGridViewColumns 具有 InheritedAutoSizeMode 属性值 ColumnHeader ， ColumnHeadersVisible 并且属性值为 false。
-或-
中至少有一列dataGridViewColumns具有InheritedAutoSizeMode属性值Fill和Frozen属性值 。true
-或-
包含dataGridViewColumnsFillWeight属性值的列将导致控件中所有列的组合FillWeight值超过 65535。
-或-
中 dataGridViewColumns 至少有两个值引用同一 DataGridViewColumn个值。
-或-
至少有一个列dataGridViewColumns具有，并且DisplayIndex属性值将在具有相反Frozen属性值的一组相邻列Frozen之间显示它。
示例
下面的代码示例演示了此方法的使用。 本示例是 “如何：设置 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."})
