HtmlSelect.Value-Eigenschaft
Ruft den Wert des im HtmlSelect-Steuerelement ausgewählten Elements ab, oder legt die SelectedIndex-Eigenschaft des Steuerelements auf den Index des ersten Elements der Liste fest, das den angegebenen Wert aufweist.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Property Value As String
'Usage
Dim instance As HtmlSelect
Dim value As String
value = instance.Value
instance.Value = value
public string Value { get; set; }
public:
property String^ Value {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_Value ()
/** @property */
public void set_Value (String value)
public function get Value () : String
public function set Value (value : String)
Eigenschaftenwert
Der Wert des ausgewählten Elements im HtmlSelect-Steuerelement. Wenn im Steuerelement kein Element ausgewählt ist, wird String.Empty zurückgegeben.
Hinweise
Die Value-Eigenschaft wird häufig zum Abrufen des Werts des Elements verwendet, auf das durch die SelectedIndex-Eigenschaft verwiesen wird.
Hinweis
Wenn im Steuerelement kein Element ausgewählt ist, wird String.Empty zurückgegeben.
Wenn Sie diese Eigenschaft auf einen Wert festlegen, wird die SelectedIndex-Eigenschaft mit dem Index des ersten Elements in der Liste aktualisiert, das diesen Wert enthält. Wenn kein übereinstimmender Wert gefunden wird, wird die SelectedIndex-Eigenschaft nicht geändert.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit der Value-Eigenschaft den Wert des im HtmlSelect-Steuerelement ausgewählten Elements abrufen.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub Button_Click (sender As Object, e As EventArgs)
Label1.Text = "You selected the item with index number " & _
Select1.SelectedIndex.ToString() & _
" and contains the value " & _
Select1.Value & "."
End Sub
</script>
</head>
<body>
<form runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br><br>
<select id="Select1"
Multiple="False"
runat="server">
<option value="Text for Item 1" Selected="True"> Item 1 </option>
<option value="Text for Item 2"> Item 2 </option>
<option value="Text for Item 3"> Item 3 </option>
<option value="Text for Item 4"> Item 4 </option>
<option value="Text for Item 5"> Item 5 </option>
<option value="Text for Item 6"> Item 6 </option>
</select>
<br><br>
<button id="Button1"
OnServerClick="Button_Click"
runat="server">
Submit
</button>
<br><br>
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void Button_Click (Object sender, EventArgs e)
{
Label1.Text = "You selected the item with index number " +
Select1.SelectedIndex.ToString() +
" and contains the value " +
Select1.Value + ".";
}
</script>
</head>
<body>
<form runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br><br>
<select id="Select1"
Multiple="False"
runat="server">
<option value="Text for Item 1" Selected="True"> Item 1 </option>
<option value="Text for Item 2"> Item 2 </option>
<option value="Text for Item 3"> Item 3 </option>
<option value="Text for Item 4"> Item 4 </option>
<option value="Text for Item 5"> Item 5 </option>
<option value="Text for Item 6"> Item 6 </option>
</select>
<br><br>
<button id="Button1"
OnServerClick="Button_Click"
runat="server">
Submit
</button>
<br><br>
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
function Button_Click (sender : Object, e: EventArgs) : void
{
Label1.Text = "You selected the item with index number " +
Select1.SelectedIndex.ToString() +
" and contains the value " +
Select1.Value + ".";
}
</script>
</head>
<body>
<form runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br><br>
<select id="Select1"
Multiple="False"
runat="server">
<option value="Text for Item 1" Selected="True"> Item 1 </option>
<option value="Text for Item 2"> Item 2 </option>
<option value="Text for Item 3"> Item 3 </option>
<option value="Text for Item 4"> Item 4 </option>
<option value="Text for Item 5"> Item 5 </option>
<option value="Text for Item 6"> Item 6 </option>
</select>
<br><br>
<button id="Button1"
OnServerClick="Button_Click"
runat="server">
Submit
</button>
<br><br>
<asp:Label id="Label1"
runat="server"/>
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
HtmlSelect-Klasse
HtmlSelect-Member
System.Web.UI.HtmlControls-Namespace
HtmlSelect.SelectedIndex-Eigenschaft
String.Empty