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，且 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."})