Collection.IList.Insert(Int32, Object) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將項目插入至指定之索引的 Collection 物件。

 virtual void IListInsert(int index, System::Object ^ value) = System::Collections::IList::Insert;

void IList.Insert (int index, object value);

abstract member IListInsert : int * obj -> unit
override this.IListInsert : int * obj -> unit

Sub IListInsert (index As Integer, value As Object) Implements IList.Insert

應在 value 插入以零為起始的索引。

要插入至 Object 物件的 Collection。

index 不是 Collection 物件中的有效索引。

Collection 物件為唯讀。

-或-

Collection 物件具有固定的大小。

value 是 Collection 物件中的 null 參考。

如果 index 等於物件中的 Collection 項目數，則會 value 附加至結尾。

在連續項目的集合 (例如清單) 中，後面接著插入點的項目會向下移動以容納新項目。如果集合具有索引，則移動之項目的索引也會更新。集合的項目若在概念上群組成 Bucket (例如雜湊資料表)，則不適用這項行為。