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.None 或 以外的值，则 ListViewItemSorter 列表在插入项后排序。

若要添加项，但不指定集合中的特定位置以添加该项，请使用 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.None 或 以外的值，则 ListViewItemSorter 列表在插入项后排序。

若要添加项而不在集合中指定特定位置，请使用 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.None 或 以外的值，则 ListViewItemSorter 列表在插入项后排序。

还可以使用此版本的 Insert 方法指定项的图像，方法是将分配给 ListView.LargeImageList 和 ListView.SmallImageList 属性的 ImageList 索引传递给 imageIndex 参数。 (通常， ListView.LargeImageList 和 ListView.SmallImageList 属性使用相同的索引位置来显示相关图像。) 如果不想为项指定图像索引，请使用接受字符串作为参数的其他方法版本 Insert 。

若要添加项而不在集合中指定特定位置，请使用 Add 方法。 如果要将项数组添加到集合，请使用 AddRange 方法。

另请参阅

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