ListView.ListViewItemCollection.Add 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将项添加到项集合中。
重载
| 名称 | 说明 |
|---|---|
| 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);public virtual System.Windows.Forms.ListViewItem Add(string? text);abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (text As String) As ListViewItem参数
- text
- String
要为项显示的文本。
返回
已 ListViewItem 添加到集合中的项。
注解
可以使用此方法的 Add 此版本创建新的 ListViewItem 控件以添加到 ListView 控件。 添加到控件的新 ListViewItem 文本基于 text 参数。 如果要为项指定映像，请使用接受图像索引作为参数的方法的版本 Add 。 如果有ListViewItem要添加到集合的现有方法，请使用接受其ListViewItem参数的方法版本Add。
ListView.Sorting如果该属性设置为除该属性以外的SortOrder.None值或设置ListViewItemSorter该属性的值，则列表在添加项后排序。 否则，该项将插入列表末尾。 如果未对列表进行排序，则可以使用 Insert 该方法将项 ListView 插入到特定位置。 若要在单个操作中向控件添加一组项，请使用 AddRange 该方法。 如果要使用 Add 该方法向控件添加大量项，请使用 BeginUpdate 和 EndUpdate 方法防止 ListView 重新绘制，直到添加所有项。 将项添加到 a ListView时，首先对项进行排序，然后添加新项会更高效。
另请参阅
适用于
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.ListViewItemPublic Overridable Function Add (value As ListViewItem) As ListViewItem参数
- value
- ListViewItem
ListViewItem要添加到集合中。
返回
已 ListViewItem 添加到集合中的项。
注解
可以使用此方法的 Add 此版本将现有 ListViewItem 添加到集合中。 此方法的 Add 此版本通常用于重用其他控件中的 ListView 项，或者在 ListViewItem 将项添加到集合之前手动创建。 如果要创建新 ListViewItem 项而不是使用现有项，请使用该方法的其他版本 Add 。
ListView.Sorting如果该属性设置为除该属性以外的SortOrder.None值或设置ListViewItemSorter该属性的值，则列表在添加项后排序。 否则，该项将插入列表末尾。 如果未对列表进行排序，则可以使用 Insert 该方法将项 ListView 插入到特定位置。 若要在单个操作中向控件添加一组项，请使用 AddRange 该方法。 如果要使用 Add 该方法向控件添加大量项，请使用 BeginUpdate 和 EndUpdate 方法防止 ListView 重新绘制，直到添加所有项。 将项添加到 a ListView时，首先对项进行排序，然后添加新项会更高效。
此方法的 Add 此版本还用于向 a ListViewItemListViewGroup分配 。
另请参阅
适用于
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);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.ListViewItemPublic Overridable Function Add (text As String, imageIndex As Integer) As ListViewItem参数
- text
- String
项的文本。
- imageIndex
- Int32
要为项显示的图像的索引。
返回
已 ListViewItem 添加到集合中的项。
注解
可以使用此方法的 Add 此版本创建新的 ListViewItem 控件以添加到控件 ListView 。 添加到控件的新 ListViewItem 文本基于 text 参数。 还可以通过将分配给ListView.LargeImageList项的ImageList索引和ListView.SmallImageList属性传递给imageIndex参数来指定项的图像。 （通常， ListView.LargeImageList 属性 ListView.SmallImageList 使用相同的索引位置来显示相关图像。如果不想指定项的图像索引，请使用仅接受字符串作为参数的方法的版本 Add 。 如果有ListViewItem要添加到集合的现有方法，请使用接受其ListViewItem参数的方法版本Add。
ListView.Sorting如果该属性设置为除该属性以外的SortOrder.None值或设置ListViewItemSorter该属性的值，则列表在添加项后排序。 否则，该项将插入列表末尾。 如果未对列表进行排序，则可以使用 Insert 该方法将项 ListView 插入到特定位置。 若要在单个操作中向控件添加一组项，请使用 AddRange 该方法。 如果要使用 Add 该方法向控件添加大量项，请使用 BeginUpdate 和 EndUpdate 方法防止 ListView 重新绘制，直到添加所有项。 将项添加到 a ListView时，首先对项进行排序，然后添加新项会更高效。
另请参阅
适用于
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);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.ListViewItemPublic Overridable Function Add (text As String, imageKey As String) As ListViewItem参数
- text
- String
项的文本。
- imageKey
- String
要为项显示的图像的键。
返回
添加到 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);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.ListViewItemPublic Overridable Function Add (key As String, text As String, imageIndex As Integer) As ListViewItem参数
- key
- String
项目的名称。
- text
- String
项的文本。
- imageIndex
- Int32
要为项显示的图像的索引。
返回
添加到 ListViewItem 集合中。
例外
包含 ListView 处于虚拟模式。
注解
ListView如果已排序，则按正确的排序顺序添加该项;否则，它将添加到集合的末尾。 该 Name 属性对应于中某个 ListViewItem 项的 ListView.ListViewItemCollection键。
该方法 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);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.ListViewItemPublic Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItem参数
- key
- String
项目的名称。
- text
- String
项的文本。
- imageKey
- String
要为项显示的图像的键。
返回
添加到 ListViewItem 集合中。
注解
该 Name 属性对应于中某个 ListViewItem 项的 ListView.ListViewItemCollection键。
ListView如果已排序，则按正确的排序顺序添加该项;否则，它将添加到集合的末尾。 该方法 Add 将 Name 项的属性设置为指定的键，以便可以通过项的索引或键检索该项。
