This documentation is archived and is not being maintained.
ListItem Constructor
.NET Framework 1.1
Initializes a new instance of the ListItem class.
Overload List
Initializes a new instance of the ListItem class.
[Visual Basic] Public Sub New()
[C#] public ListItem();
[C++] public: ListItem();
[JScript] public function ListItem();
Initializes a new instance of the ListItem class with the specified text data.
[Visual Basic] Public Sub New(String)
[C#] public ListItem(string);
[C++] public: ListItem(String*);
[JScript] public function ListItem(String);
Initializes a new instance of the ListItem class with the specified text and value data.
[Visual Basic] Public Sub New(String, String)
[C#] public ListItem(string, string);
[C++] public: ListItem(String*, String*);
[JScript] public function ListItem(String, String);
Example
[Visual Basic, C#, JScript] Note This example shows how to use one of the overloaded versions of the ListItem constructor. For other examples that might be available, see the individual overload topics.
[Visual Basic] <!-- The following example demonstrates adding items to and removing items from ListBox controls. When an item is selected in ListBox1, a new ListBoxItem with the same value can be created and added to ListBox2, if ListBox2 does not already contain an item with that text. --> <%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Sub AddBtn_Click(Sender As Object, e As EventArgs) If ListBox1.SelectedIndex > -1 Then If ListBox2.Items.FindByText(ListBox1.SelectedItem.Text) is Nothing Then Dim Item As ListItem = new ListItem(ListBox1.SelectedItem.Text, _ ListBox1.SelectedItem.Value) ListBox2.Items.Add(Item) End If End If End Sub Sub DelBtn_Click(Sender As Object, e As EventArgs) If ListBox2.SelectedIndex > -1 Then ListBox2.Items.Remove(ListBox2.SelectedItem) End If End Sub </script> </head> <body> <h3>ListItem Example</h3> <p> <form runat=server> <table> <tr><td> <asp:ListBox id=ListBox1 Width="100px" runat="server"> <asp:ListItem Value="Value 1">Item 1</asp:ListItem> <asp:ListItem Value="Value 2">Item 2</asp:ListItem> <asp:ListItem Value="Value 3">Item 3</asp:ListItem> <asp:ListItem Value="Value 4">Item 4</asp:ListItem> <asp:ListItem Value="Value 5" Selected="True">Item 5</asp:ListItem> <asp:ListItem Value="Value 6">Item 6</asp:ListItem> </asp:ListBox> </td><td> <asp:button Text="--->" OnClick="AddBtn_Click" runat="server" /><br> <asp:button Text="<---" OnClick="DelBtn_Click" runat="server" /> </td><td> <asp:ListBox id=ListBox2 Width="100px" runat="server"/> </td></tr> </table> </form> </body> </html> [C#] <!-- The following example demonstrates adding items to and removing items from ListBox controls. When an item is selected in ListBox1, a new ListBoxItem with the same value can be created and added to ListBox2, if ListBox2 does not already contain an item with that text. --> <%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void AddBtn_Click(Object Sender, EventArgs e) { if (ListBox1.SelectedIndex > -1) { if (ListBox2.Items.FindByText(ListBox1.SelectedItem.Text) == null) { ListItem Item = new ListItem(ListBox1.SelectedItem.Text, ListBox1.SelectedItem.Value); ListBox2.Items.Add(Item); } } } void DelBtn_Click(Object Sender, EventArgs e) { if (ListBox2.SelectedIndex > -1) { ListBox2.Items.Remove(ListBox2.SelectedItem); } } </script> </head> <body> <h3>ListItem Example</h3> <p> <form runat=server> <table> <tr><td> <asp:ListBox id=ListBox1 Width="100px" runat="server"> <asp:ListItem Value="Value 1">Item 1</asp:ListItem> <asp:ListItem Value="Value 2">Item 2</asp:ListItem> <asp:ListItem Value="Value 3">Item 3</asp:ListItem> <asp:ListItem Value="Value 4">Item 4</asp:ListItem> <asp:ListItem Value="Value 5" Selected="True">Item 5</asp:ListItem> <asp:ListItem Value="Value 6">Item 6</asp:ListItem> </asp:ListBox> </td><td> <asp:button Text="--->" OnClick="AddBtn_Click" runat="server" /><br> <asp:button Text="<---" OnClick="DelBtn_Click" runat="server" /> </td><td> <asp:ListBox id=ListBox2 Width="100px" runat="server"/> </td></tr> </table> </form> </body> </html> [JScript] <!-- The following example demonstrates adding items to and removing items from ListBox controls. When an item is selected in ListBox1, a new ListBoxItem with the same value can be created and added to ListBox2, if ListBox2 does not already contain an item with that text. --> <%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> <script runat="server"> function AddBtn_Click(Sender : Object, e : EventArgs) { if (ListBox1.SelectedIndex > -1) { if (ListBox2.Items.FindByText(ListBox1.SelectedItem.Text) == null) { var Item : ListItem = new ListItem(ListBox1.SelectedItem.Text, ListBox1.SelectedItem.Value); ListBox2.Items.Add(Item); } } } function DelBtn_Click(Sender : Object, e : EventArgs) { if (ListBox2.SelectedIndex > -1) { ListBox2.Items.Remove(ListBox2.SelectedItem); } } </script> </head> <body> <h3>ListItem Example</h3> <p> <form runat=server> <table> <tr><td> <asp:ListBox id=ListBox1 Width="100px" runat="server"> <asp:ListItem Value="Value 1">Item 1</asp:ListItem> <asp:ListItem Value="Value 2">Item 2</asp:ListItem> <asp:ListItem Value="Value 3">Item 3</asp:ListItem> <asp:ListItem Value="Value 4">Item 4</asp:ListItem> <asp:ListItem Value="Value 5" Selected="True">Item 5</asp:ListItem> <asp:ListItem Value="Value 6">Item 6</asp:ListItem> </asp:ListBox> </td><td> <asp:button Text="--->" OnClick="AddBtn_Click" runat="server" /><br> <asp:button Text="<---" OnClick="DelBtn_Click" runat="server" /> </td><td> <asp:ListBox id=ListBox2 Width="100px" runat="server"/> </td></tr> </table> </form> </body> </html>
[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button
in the upper-left corner of the page.
See Also
ListItem Class | ListItem Members | System.Web.UI.WebControls Namespace
Show: