ListView.ListViewItemCollection.Insert ListView.ListViewItemCollection.Insert ListView.ListViewItemCollection.Insert ListView.ListViewItemCollection.Insert Method

Определение

Вставляет элемент в коллекцию по указанному индексу.Inserts an item into the collection at the specified index.

Перегрузки

Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String)

Создает новый элемент с заданным ключом, текстом и изображением и добавляет его в коллекцию по указанному индексу.Creates a new item with the specified key, text, and image, and adds it to the collection at the specified index.

Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32)

Создает новый элемент с заданным ключом, текстом и изображением и вставляет его в коллекцию по указанному индексу.Creates a new item with the specified key, text, and image, and inserts it in the collection at the specified index.

Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String)

Создает новый элемент с заданным текстом и изображением и вставляет его в коллекцию по указанному индексу.Creates a new item with the specified text and image and inserts it in the collection at the specified index.

Insert(Int32, ListViewItem) Insert(Int32, ListViewItem) Insert(Int32, ListViewItem) Insert(Int32, ListViewItem)

Вставляет существующий ListViewItem в коллекцию по указанному индексу.Inserts an existing ListViewItem into the collection at the specified index.

Insert(Int32, String) Insert(Int32, String) Insert(Int32, String) Insert(Int32, String)

Создает новый элемент и вставляет его в коллекцию по указанному индексу.Creates a new item and inserts it into the collection at the specified index.

Insert(Int32, String, Int32) Insert(Int32, String, Int32) Insert(Int32, String, Int32) Insert(Int32, String, Int32)

Создает новый элемент с заданным индексом изображения и вставляет его в коллекцию по указанному индексу.Creates a new item with the specified image index and inserts it into the collection at the specified index.

Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String) Insert(Int32, String, String, String)

Создает новый элемент с заданным ключом, текстом и изображением и добавляет его в коллекцию по указанному индексу.Creates a new item with the specified key, text, and image, and adds it to the collection at the specified index.

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 Int32 Int32 Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.The zero-based index location where the item is inserted.

key
String String String String

Свойство Name элемента.The Name of the item.

text
String String String String

Текст данного элемента.The text of the item.

imageKey
String String String String

Ключ изображения для данного элемента.The key of the image to display for the item.

Возвраты

Атрибут ListViewItem, добавленный в коллекцию.The ListViewItem added to the collection.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Комментарии

Insert Метод задаетдлясвойстваэлементауказанныйключ,поэтомуэлементможетбытьизвлеченпоегоName индексу или ключу.The Insert method sets the Name property of the item to the specified key, so the item can be retrieved by its index or by key.

Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32) Insert(Int32, String, String, Int32)

Создает новый элемент с заданным ключом, текстом и изображением и вставляет его в коллекцию по указанному индексу.Creates a new item with the specified key, text, and image, and inserts it in the collection at the specified index.

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 Int32 Int32 Int32

Место индекса (с нуля), куда вставлен элемент.The zero-based index location where the item is inserted

key
String String String String

Свойство Name элемента.The Name of the item.

text
String String String String

Текст данного элемента.The text of the item.

imageIndex
Int32 Int32 Int32 Int32

Индекс изображения для данного элемента.The index of the image to display for the item.

Возвраты

Атрибут ListViewItem, добавленный в коллекцию.The ListViewItem added to the collection.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Комментарии

Insert Метод задаетдлясвойстваэлементауказанныйключ,поэтомуэлементможетбытьизвлеченпоегоName индексу или ключу.The Insert method sets the Name property of the item to the specified key, so the item can be retrieved by its index or by key.

Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String) Insert(Int32, String, String)

Создает новый элемент с заданным текстом и изображением и вставляет его в коллекцию по указанному индексу.Creates a new item with the specified text and image and inserts it in the collection at the specified index.

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 Int32 Int32 Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.The zero-based index location where the item is inserted.

text
String String String String

Текст объекта ListViewItem.The text of the ListViewItem.

imageKey
String String String String

Ключ изображения для данного элемента.The key of the image to display for the item.

Возвраты

Атрибут ListViewItem, добавленный в коллекцию.The ListViewItem added to the collection.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Insert(Int32, ListViewItem) Insert(Int32, ListViewItem) Insert(Int32, ListViewItem) Insert(Int32, ListViewItem)

Вставляет существующий ListViewItem в коллекцию по указанному индексу.Inserts an existing ListViewItem into the collection at the specified index.

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 Int32 Int32 Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.The zero-based index location where the item is inserted.

item
ListViewItem ListViewItem ListViewItem ListViewItem

Объект ListViewItem, представляющий вставляемый элемент.The ListViewItem that represents the item to insert.

Возвраты

Объект ListViewItem, вставленный в коллекцию.The ListViewItem that was inserted into the collection.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Комментарии

Эта версия Insert метода позволяет вставить существующий ListViewItem объект в определенное расположение в ListView.ListViewItemCollection.This version of the Insert method allows you to insert an existing ListViewItem at a specific position in the ListView.ListViewItemCollection.

Примечание

Если свойству присвоено значение, отличное от SortOrder.None , или если ListViewItemSorter свойство задано, список сортируется после вставки элемента. ListView.SortingIf the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is inserted.

Чтобы добавить элемент, не указывая определенную позицию в коллекции для добавления элемента, используйте Add метод.To add an item without specifying a specific position in the collection to add the item, use the Add method. Если требуется добавить в коллекцию массив элементов, используйте AddRange метод.If you want to add an array of items to the collection, use the AddRange method. Этот метод можно использовать, если требуется вставить новый элемент в существующую коллекцию элементов.You can use this method if you want to insert a new item into an existing collection of items.

Дополнительно

Insert(Int32, String) Insert(Int32, String) Insert(Int32, String) Insert(Int32, String)

Создает новый элемент и вставляет его в коллекцию по указанному индексу.Creates a new item and inserts it into the collection at the specified index.

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 Int32 Int32 Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.The zero-based index location where the item is inserted.

text
String String String String

Текст, отображаемый для элемента.The text to display for the item.

Возвраты

Объект ListViewItem, вставленный в коллекцию.The ListViewItem that was inserted into the collection.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Комментарии

Эта версия Insert метода позволяет вставить новый элемент в заданную позицию ListView.ListViewItemCollectionв.This version of the Insert method allows you to insert a new item at a specific position in the ListView.ListViewItemCollection. Текст, указанный в text параметре, используется для создания нового ListViewItem , который затем вставляется в в ListView.ListViewItemCollection указанное место.The text specified in the text parameter is used to create a new ListViewItem that is then inserted into the ListView.ListViewItemCollection at the specified location.

Примечание

Если свойству присвоено значение, отличное от SortOrder.None , или если ListViewItemSorter свойство задано, список сортируется после вставки элемента. ListView.SortingIf the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is inserted.

Чтобы добавить элемент без указания определенной позиции в коллекции, используйте Add метод.To add an item without specifying a specific position in the collection, use the Add method. Если требуется добавить в коллекцию массив элементов, используйте AddRange метод.If you want to add an array of items to the collection, use the AddRange method. Этот метод можно использовать, если требуется вставить новый элемент в существующую коллекцию элементов.You can use this method if you want to insert a new item into an existing collection of items.

Дополнительно

Insert(Int32, String, Int32) Insert(Int32, String, Int32) Insert(Int32, String, Int32) Insert(Int32, String, Int32)

Создает новый элемент с заданным индексом изображения и вставляет его в коллекцию по указанному индексу.Creates a new item with the specified image index and inserts it into the collection at the specified index.

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 Int32 Int32 Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.The zero-based index location where the item is inserted.

text
String String String String

Текст, отображаемый для элемента.The text to display for the item.

imageIndex
Int32 Int32 Int32 Int32

Индекс изображения для данного элемента.The index of the image to display for the item.

Возвраты

Объект ListViewItem, вставленный в коллекцию.The ListViewItem that was inserted into the collection.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Комментарии

Эта версия Insert метода позволяет вставить новый элемент в заданную позицию ListView.ListViewItemCollectionв.This version of the Insert method allows you to insert a new item at a specific position in the ListView.ListViewItemCollection. Текст, указанный в text параметре, используется для создания нового ListViewItem , который затем вставляется в в ListView.ListViewItemCollection указанное место.The text specified in the text parameter is used to create a new ListViewItem that is then inserted into the ListView.ListViewItemCollection at the specified location.

Примечание

Если свойству присвоено значение, отличное от SortOrder.None , или если ListViewItemSorter свойство задано, список сортируется после вставки элемента. ListView.SortingIf the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is inserted.

Эту Insert версию метода также можно использовать для указания изображения для элемента путем передачи индекса ImageList объекта, назначенного ListView.LargeImageList свойствам и ListView.SmallImageList , в imageIndex параметр.You can also use this version of the Insert method to specify an image for the item by passing the index of the ImageList assigned to the ListView.LargeImageList and ListView.SmallImageList properties to the imageIndex parameter. (Как правило, ListView.LargeImageList свойства ListView.SmallImageList и используют одинаковые позиции индекса для вывода связанных изображений.) Если не нужно указывать индекс изображения для элемента, используйте другую версию Insert метода, принимающую строку в качестве параметра.(Typically, the ListView.LargeImageList and ListView.SmallImageList properties use the same index positions to display related images.) If you do not want to specify an image index for the item, use the other version of the Insert method that accepts a string as a parameter.

Чтобы добавить элемент без указания определенной позиции в коллекции, используйте Add метод.To add an item without specifying a specific position in the collection, use the Add method. Если требуется добавить в коллекцию массив элементов, используйте AddRange метод.If you want to add an array of items to the collection, use the AddRange method.

Дополнительно

Применяется к