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 插入以零為起始的索引。

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。

-或-

value 所表示之資料行具有的 DisplayIndex 和 Frozen 屬性值，會將其顯示在一組具有相反 Frozen 屬性值的相鄰資料行之間。

-或-

DataGridView 控制項至少包含一個資料列，且 value 所表示的資料行具有 CellType 屬性值 null。

備註

這個成員是明確介面成員實作， 只有在 DataGridViewColumnCollection 執行個體轉換成 IList 介面時，才能使用這個成員。

適用於

另請參閱