DataGridViewColumnCollection.IList.Add(Object) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將物件加入至集合結尾。
virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add
參數
傳回
已加入 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 介面時,才能使用這個成員。