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 меньше 0 или больше значения свойства 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 меньше 0 или больше значения свойства 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 меньше 0 или больше значения свойства 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 меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.

Комментарии

Эта версия Insert метода позволяет вставлять существующий ListViewItem объект в определенную позицию ListView.ListViewItemCollectionв .

Примечание

Если свойству 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 меньше 0 или больше значения свойства 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 меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.

Комментарии

Эта версия Insert метода позволяет вставить новый элемент в определенную позицию ListView.ListViewItemCollectionв . Текст, указанный в параметре text , используется для создания нового ListViewItem объекта , который затем вставляется в ListView.ListViewItemCollection в указанном расположении.

Примечание

Если свойству ListView.Sorting присвоено значение, отличное от SortOrder.None или если ListViewItemSorter свойство задано, список сортируется после вставки элемента.

Эту версию Insert метода также можно использовать для указания изображения для элемента путем передачи индекса, присвоенного ImageList свойствам ListView.LargeImageList и ListView.SmallImageList , в imageIndex параметр . (Как правило, ListView.LargeImageList свойства и ListView.SmallImageList используют одинаковые позиции индекса для отображения связанных изображений.) Если вы не хотите указывать индекс изображения для элемента, используйте другую версию Insert метода , которая принимает строку в качестве параметра.

Чтобы добавить элемент без указания конкретной позиции в коллекции, используйте Add метод . Если вы хотите добавить массив элементов в коллекцию, используйте AddRange метод .

См. также раздел

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