ListView.ListViewItemCollection.Insert 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

在指定的索引處插入一個項目。

多載

名稱	Description
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)

來源:

ListView.ListViewItemCollection.cs

建立一個包含指定鍵、文字與圖片的新項目，並將其加入指定的索引集合。

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小於 0 或大於 的ListView.ListViewItemCollection性質值Count。

備註

該方法將 Insert 項目的屬性設定 Name 為指定的鍵，因此該項目可以透過其索引或鍵來檢索。

Insert(Int32, String, String, Int32)

來源:

ListView.ListViewItemCollection.cs

建立一個包含指定鍵、文字與圖片的新項目，並將其插入指定的索引中。

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小於 0 或大於 的ListView.ListViewItemCollection性質值Count。

備註

該方法將 Insert 項目的屬性設定 Name 為指定的鍵，因此該項目可以透過其索引或鍵來檢索。

Insert(Int32, String, String)

來源:

ListView.ListViewItemCollection.cs

建立一個包含指定文字與圖片的新項目，並將其插入指定的索引中。

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小於 0 或大於 的ListView.ListViewItemCollection性質值Count。

Insert(Int32, ListViewItem)

來源:

ListView.ListViewItemCollection.cs

在指定索引處將一個存在 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小於 0 或大於 的ListView.ListViewItemCollection性質值Count。

備註

此版本Insert方法允許你在 中ListView.ListViewItemCollection插入一個存在ListViewItem於特定位置的 。

備註

如果 ListView.Sorting 屬性被設定為非 SortOrder.None 值，或 ListViewItemSorter 屬性被設定，則在插入該項目後，清單會被排序。

若要新增項目，且不指定在集合中的特定位置，請使用該 Add 方法。 如果你想在集合中加入一個項目陣列，可以使用這個 AddRange 方法。 如果你想將新項目插入現有的物品集合，可以使用這個方法。

另請參閱

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

Insert(Int32, String)

來源:

ListView.ListViewItemCollection.cs

建立一個新項目，並將其插入指定的索引集合中。

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小於 0 或大於 的ListView.ListViewItemCollection性質值Count。

備註

此版本 Insert 允許你在 中 ListView.ListViewItemCollection特定位置插入新項目。 參數中指定的 text 文字用來建立新 ListViewItem 文字，然後在指定位置插入 ListView.ListViewItemCollection 。

備註

如果 ListView.Sorting 屬性被設定為非 SortOrder.None 值，或 ListViewItemSorter 屬性被設定，則在插入該項目後，清單會被排序。

若要新增項目而不指定集合中的特定位置，請使用該 Add 方法。 如果你想在集合中加入一個項目陣列，可以使用這個 AddRange 方法。 如果你想將新項目插入現有的物品集合，可以使用這個方法。

另請參閱

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

Insert(Int32, String, Int32)

來源:

ListView.ListViewItemCollection.cs

建立一個包含指定圖片索引的新項目，並將其插入指定的索引集合中。

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小於 0 或大於 的ListView.ListViewItemCollection性質值Count。

備註

此版本 Insert 允許你在 中 ListView.ListViewItemCollection特定位置插入新項目。 參數中指定的 text 文字用來建立新 ListViewItem 文字，然後在指定位置插入 ListView.ListViewItemCollection 。

備註

如果 ListView.Sorting 屬性被設定為非 SortOrder.None 值，或 ListViewItemSorter 屬性被設定，則在插入該項目後，清單會被排序。

你也可以用這個版本Insert的方法，透過將 和 屬性的指派ListView.LargeImageListListView.SmallImageList索引ImageList傳遞給imageIndex參數，來指定項目的圖片。 （通常， ListView.LargeImageList 和 ListView.SmallImageList 屬性會使用相同的索引位置來顯示相關影像。）如果你不想為項目 Insert 指定影像索引，可以使用接受字串作為參數的方法版本。

若要新增項目而不指定集合中的特定位置，請使用該 Add 方法。 如果你想在集合中加入一個項目陣列，可以使用這個 AddRange 方法。

另請參閱

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