ListView.ListViewItemCollection.Insert Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Belirtilen dizinde koleksiyona bir öğe ekler.

Aşırı Yüklemeler

Insert(Int32, String, String, String)	Belirtilen anahtar, metin ve görüntüyle yeni bir öğe oluşturur ve bunu belirtilen dizindeki koleksiyona ekler.
Insert(Int32, String, String, Int32)	Belirtilen anahtar, metin ve görüntüyle yeni bir öğe oluşturur ve bunu belirtilen dizindeki koleksiyona ekler.
Insert(Int32, String, String)	Belirtilen metin ve görüntüyle yeni bir öğe oluşturur ve bunu belirtilen dizindeki koleksiyona ekler.
Insert(Int32, ListViewItem)	Belirtilen dizindeki koleksiyona var olan ListViewItem bir ekler.
Insert(Int32, String)	Yeni bir öğe oluşturur ve bunu belirtilen dizindeki koleksiyona ekler.
Insert(Int32, String, Int32)	Belirtilen görüntü dizinine sahip yeni bir öğe oluşturur ve bunu belirtilen dizindeki koleksiyona ekler.

Insert(Int32, String, String, String)

Belirtilen anahtar, metin ve görüntüyle yeni bir öğe oluşturur ve bunu belirtilen dizindeki koleksiyona ekler.

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Insert (int index, string? key, string? text, string? imageKey);

abstract member Insert : int * string * string * string -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem

Parametreler

index

Int32

Öğenin eklendiği sıfır tabanlı dizin konumu.

key

String

Öğenin Name öğesi.

text

String

Öğenin metni.

imageKey

String

Öğenin görüntüleneceği görüntünün anahtarı.

Döndürülenler

ListViewItem

koleksiyona ListViewItem eklendi.

Özel durumlar

ArgumentOutOfRangeException

index parametresi 0'dan küçük veya özelliğinin Count değerinden ListView.ListViewItemCollectionbüyük.

Açıklamalar

Insert yöntemi öğenin özelliğini belirtilen anahtara ayarlarName, böylece öğe dizini veya anahtarıyla alınabilir.

Insert(Int32, String, String, Int32)

Belirtilen anahtar, metin ve görüntüyle yeni bir öğe oluşturur ve bunu belirtilen dizindeki koleksiyona ekler.

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Insert (int index, string? key, string? text, int imageIndex);

abstract member Insert : int * string * string * int -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItem

Parametreler

index

Int32

Öğenin eklendiği sıfır tabanlı dizin konumu.

key

String

Öğenin Name öğesi.

text

String

Öğenin metni.

imageIndex

Int32

Öğenin görüntüleneceği görüntünün dizini.

Döndürülenler

ListViewItem

koleksiyona ListViewItem eklendi.

Özel durumlar

ArgumentOutOfRangeException

index parametresi 0'dan küçük veya özelliğinin Count değerinden ListView.ListViewItemCollectionbüyük.

Açıklamalar

Insert yöntemi öğenin özelliğini belirtilen anahtara ayarlarName, böylece öğe dizini veya anahtarıyla alınabilir.

Insert(Int32, String, String)

Belirtilen metin ve görüntüyle yeni bir öğe oluşturur ve bunu belirtilen dizindeki koleksiyona ekler.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, System::String ^ imageKey);

public System.Windows.Forms.ListViewItem Insert (int index, string? text, string? imageKey);

member this.Insert : int * string * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem

Parametreler

index

Int32

Öğenin eklendiği sıfır tabanlı dizin konumu.

text

String

metninin .ListViewItem

imageKey

String

Öğenin görüntüleneceği görüntünün anahtarı.

Döndürülenler

ListViewItem

koleksiyona ListViewItem eklendi.

Özel durumlar

ArgumentOutOfRangeException

index parametresi 0'dan küçük veya özelliğinin Count değerinden ListView.ListViewItemCollectionbüyük.

Insert(Int32, ListViewItem)

Belirtilen dizindeki koleksiyona var olan ListViewItem bir ekler.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::Windows::Forms::ListViewItem ^ item);

public System.Windows.Forms.ListViewItem Insert (int index, System.Windows.Forms.ListViewItem item);

member this.Insert : int * System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, item As ListViewItem) As ListViewItem

Parametreler

index

Int32

Öğenin eklendiği sıfır tabanlı dizin konumu.

item

ListViewItem

ListViewItem Eklenecek öğeyi temsil eden.

Döndürülenler

ListViewItem

ListViewItem Koleksiyona eklenen.

Özel durumlar

ArgumentOutOfRangeException

index parametresi 0'dan küçük veya özelliğinin Count değerinden ListView.ListViewItemCollectionbüyük.

Açıklamalar

Yönteminin Insert bu sürümü, içinde belirli bir konumda var olan ListViewItem bir öğeyi eklemenize ListView.ListViewItemCollectionolanak tanır.

Not

ListView.Sorting Özellik dışında bir değere SortOrder.None ayarlanırsa veya özelliği ayarlanırsaListViewItemSorter, liste öğe eklendikten sonra sıralanır.

Öğeyi eklemek üzere koleksiyonda belirli bir konum belirtmeden öğe eklemek için yöntemini kullanın Add . Koleksiyona bir öğe dizisi eklemek istiyorsanız yöntemini kullanın AddRange . Varolan bir öğe koleksiyonuna yeni bir öğe eklemek istiyorsanız bu yöntemi kullanabilirsiniz.

Ayrıca bkz.

• Add(String)
• AddRange(ListViewItem[])

Insert(Int32, String)

Yeni bir öğe oluşturur ve bunu belirtilen dizindeki koleksiyona ekler.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);

public System.Windows.Forms.ListViewItem Insert (int index, string? text);

member this.Insert : int * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String) As ListViewItem

Parametreler

index

Int32

Öğenin eklendiği sıfır tabanlı dizin konumu.

text

String

Öğe için görüntülenecek metin.

Döndürülenler

ListViewItem

ListViewItem Koleksiyona eklenen.

Özel durumlar

ArgumentOutOfRangeException

index parametresi 0'dan küçük veya özelliğinin Count değerinden ListView.ListViewItemCollectionbüyük.

Açıklamalar

Yönteminin Insert bu sürümü, içinde belirli bir konuma yeni bir öğe eklemenize ListView.ListViewItemCollectionolanak tanır. parametresinde text belirtilen metin, daha sonra belirtilen konumda içine ListView.ListViewItemCollection eklenen yeni ListViewItem bir oluşturmak için kullanılır.

Not

ListView.Sorting Özellik dışında bir değere SortOrder.None ayarlanırsa veya özelliği ayarlanırsaListViewItemSorter, liste öğe eklendikten sonra sıralanır.

Koleksiyonda belirli bir konum belirtmeden öğe eklemek için yöntemini kullanın Add . Koleksiyona bir öğe dizisi eklemek istiyorsanız yöntemini kullanın AddRange . Varolan bir öğe koleksiyonuna yeni bir öğe eklemek istiyorsanız bu yöntemi kullanabilirsiniz.

Ayrıca bkz.

• Add(String)
• AddRange(ListViewItem[])

Insert(Int32, String, Int32)

Belirtilen görüntü dizinine sahip yeni bir öğe oluşturur ve bunu belirtilen dizindeki koleksiyona ekler.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, int imageIndex);

public System.Windows.Forms.ListViewItem Insert (int index, string? text, int imageIndex);

member this.Insert : int * string * int -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem

Parametreler

index

Int32

Öğenin eklendiği sıfır tabanlı dizin konumu.

text

String

Öğe için görüntülenecek metin.

imageIndex

Int32

Öğenin görüntüleneceği görüntünün dizini.

Döndürülenler

ListViewItem

ListViewItem Koleksiyona eklenen.

Özel durumlar

ArgumentOutOfRangeException

index parametresi 0'dan küçük veya özelliğinin Count değerinden ListView.ListViewItemCollectionbüyük.

Açıklamalar

Yönteminin Insert bu sürümü, içinde belirli bir konuma yeni bir öğe eklemenize ListView.ListViewItemCollectionolanak tanır. parametresinde text belirtilen metin, daha sonra belirtilen konumda içine ListView.ListViewItemCollection eklenen yeni ListViewItem bir oluşturmak için kullanılır.

Not

ListView.Sorting Özellik dışında bir değere SortOrder.None ayarlanırsa veya özelliği ayarlanırsaListViewItemSorter, liste öğe eklendikten sonra sıralanır.

Ve özelliklerine InsertimageIndex atanan ListView.LargeImageListListView.SmallImageList dizinini parametresine geçirerek öğenin görüntüsünü belirtmek için yönteminin ImageList bu sürümünü de kullanabilirsiniz. (Ve özellikleri genellikle ListView.LargeImageListListView.SmallImageList ilgili görüntüleri görüntülemek için aynı dizin konumlarını kullanır.) Öğe için görüntü dizini belirtmek istemiyorsanız, yöntemin parametre olarak dize kabul eden diğer sürümünü Insert kullanın.

Koleksiyonda belirli bir konum belirtmeden öğe eklemek için yöntemini kullanın Add . Koleksiyona bir öğe dizisi eklemek istiyorsanız yöntemini kullanın AddRange .

Ayrıca bkz.

• Add(String)
• AddRange(ListViewItem[])