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)

Исходный код:

ListView.ListViewItemCollection.cs

Создает новый элемент с указанным ключом, текстом и изображением и добавляет его в коллекцию по указанному индексу.

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)

Исходный код:

ListView.ListViewItemCollection.cs

Создает новый элемент с указанным ключом, текстом и изображением и вставляет его в коллекцию по указанному индексу.

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)

Исходный код:

ListView.ListViewItemCollection.cs

Создает новый элемент с указанным текстом и изображением и вставляет его в коллекцию по указанному индексу.

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)

Исходный код:

ListView.ListViewItemCollection.cs

Вставляет существующую 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)

Исходный код:

ListView.ListViewItemCollection.cs

Создает новый элемент и вставляет его в коллекцию по указанному индексу.

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)

Исходный код:

ListView.ListViewItemCollection.cs

Создает новый элемент с указанным индексом изображения и вставляет его в коллекцию по указанному индексу.

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[])