This documentation is archived and is not being maintained.

HtmlSelect::Value Property

Gets the value of the selected item in the HtmlSelect control or sets the SelectedIndex property of the control to the index of the first item in the list with the specified value.

Namespace:  System.Web.UI.HtmlControls
Assembly:  System.Web (in System.Web.dll)

public:
property String^ Value {
	String^ get ();
	void set (String^ value);
}
<asp:HtmlSelect Value="String" />

Property Value

Type: System::String
The value of the selected item in the HtmlSelect control. If no item is selected in the control, String::Empty is returned.

ExceptionCondition
ArgumentOutOfRangeException

The Value property was set to an item greater than the number of items in the HtmlSelect control or less than -1.

The Value property is commonly used to get the value of the item referenced by the SelectedIndex property.

NoteNote

If no item is selected in the control, String::Empty is returned.

If you set this property to a value, the SelectedIndex property is updated with the index of the first item in the list that contains that value. If no matching value is found, the SelectedIndex property is left unchanged.

The following code example demonstrates how to use the Value property to get the value of the selected item in the HtmlSelect control.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

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.
Show: