.NET Framework Class Library
ListItem.Value Property
Gets or sets the value associated with the ListItem.
Assembly: System.Web (in System.Web.dll)
Syntax
Visual Basic
Public Property Value As String
C#
public string Value { get; set; }
Visual C++
public: property String^ Value { String^ get (); void set (String^ value); }
F#
member Value : string with get, set
Property Value
Type: System.StringThe value associated with the ListItem. The default is String.Empty.
Remarks
Use the Value property to specify or determine the value associated with the ListItem.
Note
|
|---|
|
If the Value property contains null, the get accessor returns the value of the Text property. If the Text property, in turn, contains null, String.Empty is returned. |
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.
Examples
|
Note
|
|---|
|
The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see ASP.NET Web Page Code Model. |
Visual Basic
<%@ Page Language="VB" %> <!-- 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 value. When the new ListBoxItem is created, it receives the Value property of the selected item as its Text property, and the Text property of the selected item as its value property. --> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title>ListItem Example</title> <script language="VB" runat="server"> Sub AddBtn_Click(Sender As Object, e As EventArgs) If ListBox1.SelectedIndex > -1 Then If ListBox2.Items.FindByValue(ListBox1.SelectedItem.Text) is Nothing Then Dim Item As ListItem = new ListItem() 'Text and Value are swapped Item.Text = ListBox1.SelectedItem.Value Item.Value = ListBox1.SelectedItem.Text 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> <form id="form1" 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 value. When the new ListBoxItem is created, it receives the Value property of the selected item as its Text property, and the Text property of the selected item as its value property. --> <%@ Page Language="C#" AutoEventWireup="True" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title>ListItem Example</title> <script runat="server"> void AddBtn_Click(Object Sender, EventArgs e) { if (ListBox1.SelectedIndex > -1) { if (ListBox2.Items.FindByValue(ListBox1.SelectedItem.Text) == null) { ListItem Item = new ListItem(); // Text and Value are swapped. Item.Text = ListBox1.SelectedItem.Value; Item.Value = ListBox1.SelectedItem.Text; 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> <form id="form1" 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>
Version Information
.NET Framework
Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also