StringCollection.IList.Insert(Int32, Object) Metode

Definisi

Ruang nama:

System.Collections.Specialized

Rakitan:

System.Collections.Specialized.dll

Sumber:

StringCollection.cs

Menyisipkan elemen ke dalam pada StringCollection indeks yang ditentukan.

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

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

Parameter

index

Int32

Indeks berbasis nol di mana value harus disisipkan.

value

Object

yang akan disisipkan Object . Nilainya bisa null.

Penerapan

Insert(Int32, Object)

Pengecualian

ArgumentOutOfRangeException

index kurang dari nol.

-atau-

index lebih besar dari Count.

NotSupportedException

StringCollection bersifat baca-saja.

-atau-

StringCollection memiliki ukuran tetap.

Keterangan

Jika Count sudah sama dengan kapasitas, kapasitas StringCollection ditingkatkan dengan secara otomatis merealokasi array internal, dan elemen yang ada disalin ke array baru sebelum elemen baru ditambahkan.

Jika index sama dengan Count, value ditambahkan ke akhir StringCollection.

Dalam kumpulan elemen yang berdampingan, seperti daftar, elemen yang mengikuti titik penyisipan bergerak ke bawah untuk mengakomodasi elemen baru. Jika koleksi diindeks, indeks elemen yang dipindahkan juga diperbarui. Perilaku ini tidak berlaku untuk koleksi di mana elemen secara konseptual dikelompokkan ke dalam wadah, seperti tabel hash.

Metode ini adalah operasi O(n), di mana n adalah Count.

Lihat juga

• Add(Object)
• Remove(Object)
• Count