ListView.ListViewItemCollection.Insert 方法

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将一项插入集合中指定索引处。

重载

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);

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);

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);

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 方法。如果要将新项插入到现有项集合中，可以使用此方法。

另请参阅

适用于

Insert(Int32, String)

创建一个新项，并将其插入到集合中的指定索引处。

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

public System.Windows.Forms.ListViewItem Insert (int index, 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 方法。如果要将新项插入到现有项集合中，可以使用此方法。

另请参阅

适用于

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);

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 属性的值。

注解

注意

如果属性 ListView.Sorting 设置为除 SortOrder.None 或以外的值，则 ListViewItemSorter 列表在插入项后排序。

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

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

另请参阅

适用于

通过

ListView.ListViewItemCollection.Insert 方法

定义

重载

Insert(Int32, String, String, String)

参数

返回

例外

注解

适用于

Insert(Int32, String, String, Int32)

参数

返回

例外

注解

适用于

Insert(Int32, String, String)

参数

返回

例外

适用于

Insert(Int32, ListViewItem)

参数

返回

例外

注解

另请参阅

适用于

Insert(Int32, String)

参数

返回

例外

注解

另请参阅

适用于

Insert(Int32, String, Int32)

参数

返回

例外

注解

另请参阅

适用于

其他资源