ListView.ListViewItemCollection.Add Metod

Definition

Namnområde:: System.Windows.Forms

Sammansättning:: System.Windows.Forms.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Lägger till ett objekt i samlingen med objekt.

Överlagringar

Name	Description
Add(String)	Skapar ett objekt med den angivna texten och lägger till det i samlingen.
Add(ListViewItem)	Lägger till en befintlig ListViewItem i samlingen.
Add(String, Int32)	Skapar ett objekt med den angivna texten och bilden och lägger till det i samlingen.
Add(String, String)	Skapar ett objekt med den angivna texten och bilden och lägger till det i samlingen.
Add(String, String, Int32)	Skapar ett objekt med den angivna nyckeln, texten och bilden och lägger till ett objekt i samlingen.
Add(String, String, String)	Skapar ett objekt med den angivna nyckeln, texten och bilden och lägger till det i samlingen.

Add(String)

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Skapar ett objekt med den angivna texten och lägger till det i samlingen.

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.ListViewItem

Public Overridable Function Add (text As String) As ListViewItem

Parametrar

text: String

Texten som ska visas för objektet.

Returer

ListViewItem

Det ListViewItem som lades till i samlingen.

Kommentarer

Du kan använda den Add här versionen av metoden för att skapa en ny ListViewItem att lägga till i en ListView kontroll. Texten i den nya ListViewItem som lagts till i kontrollen baseras på parametern text . Om du vill ange en bild för objektet använder du den version av Add metoden som accepterar ett bildindex som en parameter. Om du har en befintlig ListViewItem som du vill lägga till i samlingen använder du den version av Add metoden som accepterar en ListViewItem som dess parameter.

Om egenskapen ListView.Sorting är inställd på ett annat värde än SortOrder.None eller om ListViewItemSorter egenskapen har angetts sorteras listan efter att objektet har lagts till. Annars infogas objektet i slutet av listan. Om listan inte är sorterad kan du använda Insert metoden för att infoga ett objekt i ListView en viss position. Om du vill lägga till en uppsättning objekt i kontrollen i en enda åtgärd använder du AddRange metoden . Om du vill använda Add metoden för att lägga till ett stort antal objekt i kontrollen använder BeginUpdate du metoderna och EndUpdate för att förhindra ommålningen ListView tills alla objekt läggs till. När du lägger till objekt i en ListViewär det mer effektivt att sortera objekten först och sedan lägga till nya objekt.

Se även

Gäller för

Add(ListViewItem)

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Lägger till en befintlig ListViewItem i samlingen.

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

Parametrar

value: ListViewItem

Att ListViewItem lägga till i samlingen.

Returer

ListViewItem

Det ListViewItem som lades till i samlingen.

Kommentarer

Du kan använda den Add här versionen av metoden för att lägga till en befintlig ListViewItem i samlingen. Den här versionen av Add metoden används vanligtvis för att återanvända objekt från andra ListView kontroller eller om den ListViewItem skapades manuellt innan den lades till i samlingen. Om du vill skapa en ny ListViewItem i stället för att använda ett befintligt objekt använder du de andra versionerna Add av metoden.

Den här versionen av Add metoden används också för att tilldela en ListViewItem till en ListViewGroup.

Se även

Gäller för

Add(String, Int32)

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Skapar ett objekt med den angivna texten och bilden och lägger till det i samlingen.

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.ListViewItem

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

Parametrar

text: String

Texten i objektet.

imageIndex: Int32

Indexet för bilden som ska visas för objektet.

Returer

ListViewItem

Det ListViewItem som lades till i samlingen.

Kommentarer

Du kan använda den Add här versionen av metoden för att skapa en ny ListViewItem att lägga till i ListView kontrollen. Texten i den nya ListViewItem som lagts till i kontrollen baseras på parametern text . Du kan också ange en bild för objektet genom att skicka indexet för de ImageList tilldelade egenskaperna och ListView.LargeImageList till ListView.SmallImageList parameternimageIndex. (Egenskaperna och ListView.LargeImageList använder vanligtvis ListView.SmallImageList samma indexpositioner för att visa relaterade bilder.) Om du inte vill ange ett avbildningsindex för objektet använder du den version av Add metoden som endast accepterar en sträng som en parameter. Om du har en befintlig ListViewItem som du vill lägga till i samlingen använder du den version av Add metoden som accepterar en ListViewItem som dess parameter.

Se även

Gäller för

Add(String, String)

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Skapar ett objekt med den angivna texten och bilden och lägger till det i samlingen.

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.ListViewItem

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

Parametrar

text: String

Texten i objektet.

imageKey: String

Nyckeln för den bild som ska visas för objektet.

Returer

ListViewItem

Den ListViewItem som har lagts till i samlingen.

Kommentarer

Om sorteras ListView läggs objektet till i rätt sorterad ordning. Annars läggs det till i slutet av samlingen.

Gäller för

Add(String, String, Int32)

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Skapar ett objekt med den angivna nyckeln, texten och bilden och lägger till ett objekt i samlingen.

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.ListViewItem

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

Parametrar

key: String

Namnet på objektet.

text: String

Texten i objektet.

imageIndex: Int32

Indexet för bilden som ska visas för objektet.

Returer

ListViewItem

Den ListViewItem som har lagts till i samlingen.

Undantag

InvalidOperationException

Innehållet ListView är i virtuellt läge.

Kommentarer

Om sorteras ListView läggs objektet till i rätt sorterad ordning. Annars läggs det till i slutet av samlingen. Egenskapen Name motsvarar nyckeln för en ListViewItem i ListView.ListViewItemCollection.

Metoden Add anger Name egenskapen till den angivna nyckeln, så att objektet kan hämtas med dess index eller genom nyckel.

Gäller för

Add(String, String, String)

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Källa:: ListView.ListViewItemCollection.cs

Skapar ett objekt med den angivna nyckeln, texten och bilden och lägger till det i samlingen.

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.ListViewItem

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

Parametrar

key: String

Namnet på objektet.

text: String

Texten i objektet.

imageKey: String

Nyckeln för den bild som ska visas för objektet.

Returer

ListViewItem

Den ListViewItem som har lagts till i samlingen.

Kommentarer

Egenskapen Name motsvarar nyckeln för en ListViewItem i ListView.ListViewItemCollection.

Om sorteras ListView läggs objektet till i rätt sorterad ordning. Annars läggs det till i slutet av samlingen. Metoden Add anger Name egenskapen för objektet till den angivna nyckeln, så att objektet kan hämtas av dess index eller genom nyckel.

Gäller för

Feedback

Var den här sidan till hjälp?