ListControl.SelectedValue-Eigenschaft

Artikel
08/20/2007

Ruft den Wert des ausgewählten Elements im Listensteuerelement ab oder wählt das Element im Listensteuerelement aus, das den angegebenen Wert enthält.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<ThemeableAttribute(False)> _
<BindableAttribute(True, BindingDirection.TwoWay)> _
Public Overridable Property SelectedValue As String
'Usage
Dim instance As ListControl
Dim value As String

value = instance.SelectedValue

instance.SelectedValue = value

[ThemeableAttribute(false)] 
[BindableAttribute(true, BindingDirection.TwoWay)] 
public virtual string SelectedValue { get; set; }

[ThemeableAttribute(false)] 
[BindableAttribute(true, BindingDirection::TwoWay)] 
public:
virtual property String^ SelectedValue {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_SelectedValue ()

/** @property */
public void set_SelectedValue (String value)

public function get SelectedValue () : String

public function set SelectedValue (value : String)

Eigenschaftenwert

Der Wert des ausgewählten Elements im Listensteuerelement. Der Standardwert ist eine leere Zeichenfolge ("").

Hinweise

Diese Eigenschaft gibt die Value-Eigenschaft des ausgewählten ListItem zurück. Die SelectedValue-Eigenschaft wird im Allgemeinen zum Bestimmen des Werts des im Listensteuerelement ausgewählten Elements verwendet. Wenn mehrere Elemente ausgewählt sind, wird der Wert des ausgewählten Elements mit dem niedrigsten Index zurückgegeben. Wenn kein Element ausgewählt ist, wird eine leere Zeichenfolge ("") zurückgegeben.

Mit der SelectedValue-Eigenschaft kann außerdem ein Element im Listensteuerelement ausgewählt werden. Dazu wird die Eigenschaft auf den Wert des Elements festgelegt. Wenn kein Element im Listensteuerelement den angegebenen Wert enthält, wird eine System.ArgumentOutOfRangeException ausgelöst.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.

Beispiel

Im folgenden Beispiel wird die Verwendung der SelectedValue-Eigenschaft zum Auswählen eines Elements in einem ListBox-Steuerelement veranschaulicht. Beachten Sie, dass mit dieser Eigenschaft auch der Wert des ausgewählten Elements abgerufen werden kann.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html> 

<head>

   <script runat="server">

      Sub Button_Click(sender As Object, e As EventArgs)

         ' Perform this operation in a try-catch block in case the item is not found.
         Try
   
            List.SelectedValue = ItemTextBox.Text
            MessageLabel.Text = "You selected " & List.SelectedValue + "."
        
         Catch ex As Exception
     
            List.SelectedValue = Nothing         
            MessageLabel.Text = "Item not found in ListBox control."
     
         End Try
             
      End Sub

   </script>

</head>

<body>

   <form runat="server">

      <h3> ListControl SelectedValue Example </h3>
 
      <asp:ListBox ID="List"
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>

      </asp:ListBox>

      <hr>

      Enter the value of the item to select: <br>
      <asp:TextBox ID="ItemTextBox"
           MaxLength="6"
           Text="Item 1"
           runat="server"/>

      &nbsp;&nbsp;

      <asp:Button ID="SelectButton"
           Text="Select Item"
           OnClick="Button_Click"
           runat="server"/>

      <br><br>

      <asp:Label ID="MessageLabel"
           runat="server"/>     

   </form>

</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html> 

<head>

   <script runat="server">

      void Button_Click(Object sender, EventArgs e)
      {

         // Perform this operation in a try-catch block in case the item is not found.
         try
         {
            List.SelectedValue = ItemTextBox.Text;
            MessageLabel.Text = "You selected " + List.SelectedValue + ".";
         }
         catch (Exception ex)
         {
            List.SelectedValue = null;
            MessageLabel.Text = "Item not found in ListBox control.";
         }
             
      }

   </script>

</head>

<body>

   <form runat="server">

      <h3> ListControl SelectedValue Example </h3>
 
      <asp:ListBox ID="List"
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>

      </asp:ListBox>

      <hr>

      Enter the value of the item to select: <br>
      <asp:TextBox ID="ItemTextBox"
           MaxLength="6"
           Text="Item 1"
           runat="server"/>

      &nbsp;&nbsp;

      <asp:Button ID="SelectButton"
           Text="Select Item"
           OnClick="Button_Click"
           runat="server"/>

      <br><br>

      <asp:Label ID="MessageLabel"
           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

Siehe auch

Referenz

ListControl-Klasse
ListControl-Member
System.Web.UI.WebControls-Namespace
ListControl.SelectedItem-Eigenschaft
ListControl.SelectedIndex-Eigenschaft
ListControl.DataValueField-Eigenschaft
ListControl.Items-Eigenschaft
ListItem
System.ArgumentOutOfRangeException

Freigeben über