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 の少なくとも 1 つの値が null です。

• または - dataGridViewColumns 内の少なくとも 1 つの列が、既に DataGridView コントロールに属しています。

• または - dataGridViewColumns 内の少なくとも 1 つの列の CellType プロパティに null 値が設定され、なおかつ、DataGridView コントロールに少なくとも 1 つの行が存在します。

• または - dataGridViewColumns 内の少なくとも 1 つの列の SortMode プロパティに Automatic 値が設定され、なおかつ、SelectionMode プロパティの値が FullColumnSelect または ColumnHeaderSelect です。 競合するプロパティ値を一時的に設定するには、コントロールの ISupportInitialize.BeginInit() メソッドと ISupportInitialize.EndInit() メソッドを使用します。

• または - dataGridViewColumns 内の少なくとも 1 つの列の InheritedAutoSizeMode プロパティに ColumnHeader 値が設定され、なおかつ、ColumnHeadersVisible プロパティの値が false です。

• または - dataGridViewColumns 内の少なくとも 1 つの列の InheritedAutoSizeMode プロパティに Fill 値が設定され、なおかつ、Frozen プロパティの値が true です。

• または - dataGridViewColumns に含まれる列の FillWeight プロパティに、コントロールに含まれるすべての列の FillWeight を合わせた値が 65535 を超えるような値が設定されています。

• または - dataGridViewColumns 内の少なくとも 2 つの値が、同じ DataGridViewColumn を参照しています。

• または - 逆の DisplayIndex プロパティ値を持つ列と隣接してしまうような Frozen プロパティ値と Frozen プロパティ値が、dataGridViewColumns 内のいずれかの列に設定されています。

例

次のコード例は、このメソッドの使用方法を示しています。 この例は、「方法: 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