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の少なくとも 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."})