HtmlSelect.Value Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Wert des ausgewählten Elements im HtmlSelect Steuerelement ab oder legt die SelectedIndex Eigenschaft des Steuerelements auf den Index des ersten Elements in der Liste mit dem angegebenen Wert fest.
public:
property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };
public string Value { get; set; }
member this.Value : string with get, set
Public Property Value As String
Eigenschaftswert
Der Wert des ausgewählten Elements im HtmlSelect Steuerelement. Wenn kein Element im Steuerelement ausgewählt ist, Empty wird dieses zurückgegeben.
Ausnahmen
Die Value Eigenschaft wurde auf ein Element festgelegt, das größer als die Anzahl der Elemente im HtmlSelect Steuerelement oder kleiner als ist -1.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die Value Eigenschaft verwendet wird, um den Wert des ausgewählten Elements im HtmlSelect Steuerelement abzurufen.
<%@ 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> HtmlSelect Example </title>
<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 id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br /><br />
<select id="Select1"
runat="server">
<option value="Text for Item 1" selected="selected"> 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="VB" 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> HtmlSelect Example </title>
<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 id="form1" runat="server">
<h3> HtmlSelect Example </h3>
Select items from the list: <br /><br />
<select id="Select1"
runat="server">
<option value="Text for Item 1" selected="selected"> 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>
Hinweise
Die Value Eigenschaft wird häufig verwendet, um den Wert des Elements abzurufen, auf das von der SelectedIndex Eigenschaft verwiesen wird.
Hinweis
Wenn kein Element im Steuerelement ausgewählt ist, String.Empty wird dieses 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 übereinstimmenden Wert gefunden wird, bleibt die SelectedIndex Eigenschaft unverändert.