DataGridViewColumnCollection.IList.Insert(Int32, Object) メソッド

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

要素をコレクション内の指定されたインデックス位置に挿入します。

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
void IList.Insert (int index, object? value);
abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit
Sub Insert (index As Integer, value As Object) Implements IList.Insert

パラメーター

index
Int32

value を挿入する位置の、0 から始まるインデックス。

value
Object

挿入する Object。 値として null を指定できます。

実装

Insert(Int32, Object)

例外

InvalidCastException

value が DataGridViewColumn ではありません。

ArgumentNullException

value が nullです。

InvalidOperationException

関連付けられた DataGridView コントロールによって次のいずれかのアクションが実行されているため、一時的に新しい列が追加できない状態にあります。

  • コントロール内のすべてのセルを選択します。

  • 選択範囲をクリアします。

  • 列 DisplayIndex のプロパティ値を更新しています。

- または -

このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。

- または -

value で指定された列は既に DataGridView コントロールに属しています。

- または -

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

- または -

value で指定された列の InheritedAutoSizeMode プロパティの値が ColumnHeader で、なおかつ、ColumnHeadersVisible プロパティの値が false です。

- または -

value で指定された列の InheritedAutoSizeMode プロパティの値が Fill で、なおかつ、Frozen プロパティの値が true です。

- または -

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

- または -

逆の DisplayIndex プロパティ値を持つ列と隣接してしまうような Frozen プロパティ値と Frozen プロパティ値が、value で指定された列に設定されています。

- または -

DataGridView コントロールの、value で指定された少なくとも 1 つの行と列に、CellType プロパティの値として null が設定されています。

注釈

このメンバーは、明示的なインターフェイス メンバーの実装です。 これは、DataGridViewColumnCollection のインスタンスが IList インターフェイスにキャストされる場合のみ、使用できます。

適用対象

こちらもご覧ください