ListView.ListViewItemCollection.Insert 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將項目插入至索引中的指定索引處。

多載

Insert(Int32, String, String, String)	使用指定的索引鍵、文字和影像建立新的項目，並將它加入至集合中的指定索引處。
Insert(Int32, String, String, Int32)	使用指定的索引鍵、文字和影像建立新的項目，並將它插入至集合中的指定索引處。
Insert(Int32, String, String)	使用指定的文字和影像建立新的項目，並將它插入至集合中的指定索引處。
Insert(Int32, ListViewItem)	將現有的 ListViewItem 插入位於指定索引處的集合中。
Insert(Int32, String)	建立新的項目，並且將它插入位於指定索引處的集合中。
Insert(Int32, String, Int32)	使用指定的影像索引建立新的項目後，並將它插入位於指定索引處的集合。

Insert(Int32, String, String, String)

使用指定的索引鍵、文字和影像建立新的項目，並將它加入至集合中的指定索引處。

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

參數

index

Int32

插入項目所在的索引位置 (以零為起始)。

key

String

項目的 Name。

text

String

項目的文字。

imageKey

String

為項目顯示的影像之索引鍵。

傳回

ListViewItem

要加入至集合中的 ListViewItem。

例外狀況

ArgumentOutOfRangeException

index 參數小於零，或大於 Count 的 ListView.ListViewItemCollection 屬性值。

備註

方法 Insert 會將 Name 專案的 屬性設定為指定的索引鍵，讓專案可由索引或索引鍵擷取。

Insert(Int32, String, String, Int32)

使用指定的索引鍵、文字和影像建立新的項目，並將它插入至集合中的指定索引處。

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

參數

index

Int32

插入項目所在的索引位置 (以零為起始)。

key

String

項目的 Name。

text

String

項目的文字。

imageIndex

Int32

為項目顯示的影像索引。

傳回

ListViewItem

要加入至集合中的 ListViewItem。

例外狀況

ArgumentOutOfRangeException

index 參數小於零，或大於 Count 的 ListView.ListViewItemCollection 屬性值。

備註

方法 Insert 會將 Name 專案的 屬性設定為指定的索引鍵，讓專案可由索引或索引鍵擷取。

Insert(Int32, String, String)

使用指定的文字和影像建立新的項目，並將它插入至集合中的指定索引處。

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

參數

index

Int32

插入項目所在的索引位置 (以零為起始)。

text

String

ListViewItem 的文字。

imageKey

String

為項目顯示的影像之索引鍵。

傳回

ListViewItem

要加入至集合中的 ListViewItem。

例外狀況

ArgumentOutOfRangeException

index 參數小於零，或大於 Count 的 ListView.ListViewItemCollection 屬性值。

Insert(Int32, ListViewItem)

將現有的 ListViewItem 插入位於指定索引處的集合中。

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

參數

index

Int32

插入項目所在的索引位置 (以零為起始)。

item

ListViewItem

ListViewItem，表示要插入的項目。

傳回

ListViewItem

已插入集合中的 ListViewItem。

例外狀況

ArgumentOutOfRangeException

index 參數小於零，或大於 Count 的 ListView.ListViewItemCollection 屬性值。

備註

這個版本的 Insert 方法可讓您在 中的 ListView.ListViewItemCollection 特定位置插入現有的 ListViewItem 。

注意

ListView.Sorting如果 屬性設定為 或 SortOrder.NoneListViewItemSorter 以外的值，則會在插入專案之後排序清單。

若要新增專案，而不指定集合中的特定位置以新增專案，請使用 Add 方法。 如果您想要將專案陣列新增至集合，請使用 AddRange 方法。 如果您想要將新專案插入現有的專案集合中，可以使用這個方法。

另請參閱

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

Insert(Int32, String)

建立新的項目，並且將它插入位於指定索引處的集合中。

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

參數

index

Int32

插入項目所在的索引位置 (以零為起始)。

text

String

要顯示的項目文字。

傳回

ListViewItem

已插入集合中的 ListViewItem。

例外狀況

ArgumentOutOfRangeException

index 參數小於零，或大於 Count 的 ListView.ListViewItemCollection 屬性值。

備註

這個版本的 Insert 方法可讓您在 中的 ListView.ListViewItemCollection 特定位置插入新專案。 參數中指定的 text 文字是用來建立新的 ListViewItem ，然後插入至 ListView.ListViewItemCollection 指定位置的 。

注意

ListView.Sorting如果 屬性設定為 或 SortOrder.NoneListViewItemSorter 以外的值，則會在插入專案之後排序清單。

若要新增專案而不指定集合中的特定位置，請使用 Add 方法。 如果您想要將專案陣列新增至集合，請使用 AddRange 方法。 如果您想要將新專案插入現有的專案集合中，可以使用這個方法。

另請參閱

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

Insert(Int32, String, Int32)

使用指定的影像索引建立新的項目後，並將它插入位於指定索引處的集合。

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

參數

index

Int32

插入項目所在的索引位置 (以零為起始)。

text

String

要顯示的項目文字。

imageIndex

Int32

為項目顯示的影像索引。

傳回

ListViewItem

已插入集合中的 ListViewItem。

例外狀況

ArgumentOutOfRangeException

index 參數小於零，或大於 Count 的 ListView.ListViewItemCollection 屬性值。

備註

這個版本的 Insert 方法可讓您在 中的 ListView.ListViewItemCollection 特定位置插入新專案。 參數中指定的 text 文字是用來建立新的 ListViewItem ，然後插入至 ListView.ListViewItemCollection 指定位置的 。

注意

ListView.Sorting如果 屬性設定為 或 SortOrder.NoneListViewItemSorter 以外的值，則會在插入專案之後排序清單。

您也可以使用這個版本的 Insert 方法來指定專案的影像，方法是將指派給 ListView.LargeImageList 和 ListView.SmallImageList 屬性 imageIndex 的 ImageList 索引傳遞給 參數。 (一般而言， ListView.LargeImageList 和 ListView.SmallImageList 屬性使用相同的索引位置來顯示相關的影像。) 如果您不想指定專案的影像索引，請使用接受字串做為參數的其他方法版本 Insert 。

若要新增專案而不指定集合中的特定位置，請使用 Add 方法。 如果您想要將專案陣列新增至集合，請使用 AddRange 方法。

另請參閱

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