DataGridViewColumnCollection.IList.Insert(Int32, Object) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將元素插入集合中指定的索引處。
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
不是 DataGridViewColumn。
value
為 null
。
相關聯的 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 介面時,才能使用這個成員。