DataGridViewColumnCollection.AddRange メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridViewColumnCollection.AddRange メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

一連の列をコレクションに追加します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As DataGridViewColumnCollection
Dim dataGridViewColumns As DataGridViewColumn()

instance.AddRange(dataGridViewColumns)

C#

public virtual void AddRange (
    params DataGridViewColumn[] dataGridViewColumns
)

C++

public:
virtual void AddRange (
    ... array<DataGridViewColumn^>^ dataGridViewColumns
)

J#

public void AddRange (
    DataGridViewColumn[] dataGridViewColumns
)

JScript

public function AddRange (
    ... dataGridViewColumns : DataGridViewColumn[]
)

パラメータ

dataGridViewColumns

追加する DataGridViewColumn オブジェクトの配列。

例外

例外の種類	条件
ArgumentNullException	dataGridViewColumns が null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	関連付けられた DataGridView コントロールによって次のいずれかのアクションが実行されているため、一時的に新しい列が追加できない状態にあります。 コントロール内のすべてのセルを選択している。 選択範囲をクリアしている。 列の DisplayIndex プロパティ値を更新している。 または このメソッドが、次のいずれかに該当する DataGridView イベントのハンドラから呼び出されています。 CellEnter CellLeave CellValidating CellValidated RowEnter RowLeave RowValidated RowValidating または dataGridViewColumns の少なくとも 1 つの値が null 参照 (Visual Basic では Nothing) です。 または dataGridViewColumns 内の少なくとも 1 つの列が、既に DataGridView コントロールに属しています。 または dataGridViewColumns 内の少なくとも 1 つの列の CellType プロパティに null 参照 (Visual Basic では Nothing) 値が設定され、なおかつ、DataGridView コントロールに少なくとも 1 つの行が存在します。 または dataGridViewColumns 内の少なくとも 1 つの列の SortMode プロパティに Automatic 値が設定され、なおかつ、DataGridView.SelectionMode プロパティの値が FullColumnSelect または ColumnHeaderSelect です。競合するプロパティ値を一時的に設定するには、コントロールの System.ComponentModel.ISupportInitialize.BeginInit メソッドと System.ComponentModel.ISupportInitialize.EndInit メソッドを使用します。 または dataGridViewColumns 内の少なくとも 1 つの列の InheritedAutoSizeMode プロパティに ColumnHeader 値が設定され、なおかつ、DataGridView.ColumnHeadersVisible プロパティの値が false です。 または dataGridViewColumns 内の少なくとも 1 つの列の InheritedAutoSizeMode プロパティに Fill 値が設定され、なおかつ、Frozen プロパティの値が true です。 または dataGridViewColumns に含まれる列の FillWeight プロパティに、コントロールに含まれるすべての列の FillWeight を合わせた値が 65535 を超えるような値が設定されています。 または dataGridViewColumns 内の少なくとも 2 つの値が、同じ DataGridViewColumn を参照しています。 または 逆の Frozen プロパティ値を持つ列と隣接してしまうような DisplayIndex プロパティ値と Frozen プロパティ値が、dataGridViewColumns 内のいずれかの列に設定されています。

使用例

このメソッドの使用方法を次のコード例に示します。次の例は「方法 : Windows フォーム DataGridView コントロールのサイズ変更モードを設定する」で取り上げている例の一部です。

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewColumnCollection クラス
DataGridViewColumnCollection メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewColumn クラス