HtmlSelect.Value Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

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.

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

String

Der Wert des ausgewählten Elements im HtmlSelect-Steuerelement. Wenn im Steuerelement kein Element ausgewählt ist, wird Empty zurückgegeben.

Ausnahmen

ArgumentOutOfRangeException

Die Value-Eigenschaft wurde auf ein Element festgelegt, das größer als die Anzahl der Elemente im HtmlSelect-Steuerelement oder kleiner als -1 ist.

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 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 übereinstimmenden Wert gefunden wird, bleibt die SelectedIndex Eigenschaft unverändert.

Gilt für:

Weitere Informationen