ListView.ListViewItemCollection.Add 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

将项添至项的集合中。

重载

Add(String)	用指定的文本创建一个项并将该项添加到集合中。
Add(ListViewItem)	将现有的 ListViewItem 添加到集合中。
Add(String, Int32)	用指定的文本和图像创建一个项并将该项添加到集合中。
Add(String, String)	用指定的文本和图像创建一个项并将该项添加到集合中。
Add(String, String, Int32)	用指定的键、文本和图像创建一个项并将该项添加到集合中。
Add(String, String, String)	用指定的键、文本和图像创建一个项并将该项添加到集合中。

Add(String)

用指定的文本创建一个项并将该项添加到集合中。

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);

public virtual System.Windows.Forms.ListViewItem Add (string? text);

abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String) As ListViewItem

参数

text

String

要为该项显示的文本。

返回

ListViewItem

已添加到集合中的 ListViewItem。

注解

可以使用此版本的 Add 方法创建一个新的 ListViewItem 以添加到控件。ListView 添加到 控件的新 ListViewItem 的文本基于 text 参数。 如果要为项指定图像，请使用接受图像索引作为参数的方法的版本 Add 。 如果你有一个要添加到集合的现有ListViewItem，请使用 接受 ListViewItem 作为其参数的方法的版本Add。

如果属性 ListView.Sorting 设置为非 SortOrder.None 或 ListViewItemSorter 设置属性的值，则列表在添加项后排序。 否则，该项将插入列表的末尾。 如果未对列表进行排序，则可以使用 Insert 方法将项插入到 ListView 特定位置。 若要在单个操作中将一组项添加到 控件，请使用 AddRange 方法。 如果要使用 Add 方法向控件添加大量项，请使用 BeginUpdate 和 EndUpdate 方法来防止 重新绘制， ListView 直到添加所有项。 将项添加到 时， ListView先对项进行排序，然后添加新项更高效。

另请参阅

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(ListViewItem)

将现有的 ListViewItem 添加到集合中。

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::Windows::Forms::ListViewItem ^ value);

public virtual System.Windows.Forms.ListViewItem Add (System.Windows.Forms.ListViewItem value);

abstract member Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
override this.Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (value As ListViewItem) As ListViewItem

参数

value

ListViewItem

要添加到集合中的 ListViewItem。

返回

ListViewItem

已添加到集合中的 ListViewItem。

注解

可以使用此版本的 Add 方法将现有 ListViewItem 添加到集合。 此方法的 Add 此版本通常用于重复使用来自其他 ListView 控件的项， ListViewItem 或者如果在将 它添加到集合之前手动创建。 如果要创建新的 ListViewItem 而不是使用现有项，请使用 方法的其他版本 Add 。

如果属性 ListView.Sorting 设置为非 SortOrder.None 或 ListViewItemSorter 设置属性的值，则列表在添加项后排序。 否则，该项将插入列表的末尾。 如果未对列表进行排序，则可以使用 Insert 方法将项插入到 ListView 特定位置。 若要在单个操作中将一组项添加到 控件，请使用 AddRange 方法。 如果要使用 Add 方法向控件添加大量项，请使用 BeginUpdate 和 EndUpdate 方法来防止 重新绘制， ListView 直到添加所有项。 将项添加到 时， ListView先对项进行排序，然后添加新项更高效。

此版本的 Add 方法还用于将 分配给 ListViewItemListViewGroup。

另请参阅

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, Int32)

用指定的文本和图像创建一个项并将该项添加到集合中。

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

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

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

Public Overridable Function Add (text As String, imageIndex As Integer) As ListViewItem

参数

text

String

项的文本。

imageIndex

Int32

要为该项显示的图像的索引。

返回

ListViewItem

已添加到集合中的 ListViewItem。

注解

可以使用此版本的 Add 方法创建一个新的 ListViewItem 以添加到 控件。ListView 添加到 控件的新 ListViewItem 的文本基于 text 参数。 还可以通过将分配给 ListView.LargeImageList 和 ListView.SmallImageList 属性imageIndex的 ImageList 索引传递给 参数来指定项的图像。 (通常， ListView.LargeImageList 和 ListView.SmallImageList 属性使用相同的索引位置来显示相关图像。) 如果不想为项指定图像索引，请使用仅接受字符串作为参数的方法的版本 Add 。 如果你有一个要添加到集合的现有ListViewItem，请使用 接受 ListViewItem 作为其参数的方法的版本Add。

如果属性 ListView.Sorting 设置为非 SortOrder.None 或 ListViewItemSorter 设置属性的值，则列表在添加项后排序。 否则，该项将插入列表的末尾。 如果未对列表进行排序，则可以使用 Insert 方法将项插入到 ListView 特定位置。 若要在单个操作中将一组项添加到 控件，请使用 AddRange 方法。 如果要使用 Add 方法向控件添加大量项，请使用 BeginUpdate 和 EndUpdate 方法来防止 重新绘制， ListView 直到添加所有项。 将项添加到 时， ListView先对项进行排序，然后添加新项更高效。

另请参阅

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, String)

用指定的文本和图像创建一个项并将该项添加到集合中。

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add (string? text, string? imageKey);

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

Public Overridable Function Add (text As String, imageKey As String) As ListViewItem

参数

text

String

项的文本。

imageKey

String

要为该项显示的图像的键。

返回

ListViewItem

添加到集合中的 ListViewItem。

注解

ListView如果 已排序，则按正确排序顺序添加项;否则，会将其添加到集合的末尾。

Add(String, String, Int32)

用指定的键、文本和图像创建一个项并将该项添加到集合中。

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

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

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

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

参数

key

String

项的名称。

text

String

项的文本。

imageIndex

Int32

要为该项显示的图像的索引。

返回

ListViewItem

添加到集合中的 ListViewItem。

例外

InvalidOperationException

包含 ListView 处于虚拟模式下。

注解

ListView如果 已排序，则按正确排序顺序添加项;否则，会将其添加到集合的末尾。 属性Name对应于 中 ListView.ListViewItemCollection的 ListViewItem 键。

方法 Add 将 Name 属性设置为指定的键，因此可以按其索引或键检索该项。

Add(String, String, String)

用指定的键、文本和图像创建一个项并将该项添加到集合中。

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

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

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

Public Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItem

参数

key

String

项的名称。

text

String

项的文本。

imageKey

String

要为该项显示的图像的键。

返回

ListViewItem

添加到集合中的 ListViewItem。

注解

属性Name对应于 中 ListView.ListViewItemCollection的 ListViewItem 键。

ListView如果 已排序，则按正确排序顺序添加项;否则，会将其添加到集合的末尾。 方法 Add 将项的 属性设置为 Name 指定的键，因此可以按其索引或键检索该项。