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 Forms DataGridView Control中較大範例的一部分。

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