ListControl.SelectedValue Eigenschaft

Definition

Ruft den Wert des ausgewählten Elements im Listensteuerelement ab oder wählt das Element im Listensteuerelement aus, das den angegebenen Wert enthält.Gets the value of the selected item in the list control, or selects the item in the list control that contains the specified value.

public:
 virtual property System::String ^ SelectedValue { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.Themeable(false)]
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Bindable(true, System.ComponentModel.BindingDirection.TwoWay)]
public virtual string SelectedValue { get; set; }
member this.SelectedValue : string with get, set
Public Overridable Property SelectedValue As String

Eigenschaftswert

Der Wert des ausgewählten Elements im Listensteuerelement.The value of the selected item in the list control. Der Standardwert ist eine leere Zeichenfolge ("").The default is an empty string ("").

Attribute

Ausnahmen

Der ausgewählte Wert ist nicht in der Liste der verfügbaren Werte enthalten, und der Ansichtszustand oder sonstige Zustand wurde geladen (ein Postback wurde ausgeführt).The selected value is not in the list of available values and view state or other state has been loaded (a postback has been performed).

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die SelectedValue -Eigenschaft verwendet wird, um ein ListBox Element in einem-Steuerelement auszuwählen.The following example demonstrates how to use the SelectedValue property to select an item in a ListBox control. Beachten Sie, dass diese Eigenschaft auch zum Abrufen des Werts des ausgewählten Elements verwendet werden kann.Notice that this property can also be used to retrieve the value of the selected item.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.


<%@ 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 runat="server">
    <title> ListControl SelectedValue Example </title>
<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 id="form1" 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="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 runat="server">
    <title> ListControl SelectedValue Example </title>
<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 id="form1" 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>

Hinweise

Diese Eigenschaft gibt die Value -Eigenschaft des ausgewählten ListItemzurück.This property returns the Value property of the selected ListItem. Die SelectedValue -Eigenschaft wird häufig verwendet, um den Wert des ausgewählten Elements im Listen Steuerelement zu bestimmen.The SelectedValue property is commonly used to determine the value of the selected item in the list control. Wenn mehrere Elemente ausgewählt sind, wird der Wert des ausgewählten Elements mit dem niedrigsten Index zurückgegeben.If multiple items are selected, the value of the selected item with the lowest index is returned. Wenn kein Element ausgewählt ist, wird eine leere Zeichenfolge ("") zurückgegeben.If no item is selected, an empty string ("") is returned.

Die SelectedValue -Eigenschaft kann auch verwendet werden, um ein Element im Listen Steuerelement auszuwählen, indem es mit dem Wert des Elements festgelegt wird.The SelectedValue property can also be used to select an item in the list control by setting it with the value of the item.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden.This property cannot be set by themes or style sheet themes. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Wenn der ausgewählte Wert nicht in der Liste der verfügbaren Werte enthalten ist und ein Postback durchgeführt ArgumentOutOfRangeException wird, wird eine Ausnahme ausgelöst.When the selected value is not in the list of available values and a postback is performed, an ArgumentOutOfRangeException exception is thrown. Im folgenden Beispiel wird gezeigt, wie ein ungültiger Wert abgefangen wird, bevor ein Postback auftritt:The following example shows how to catch an invalid value before postback occurs:

Me.DropDownList1.Items.Add(New ListItem( Text="Hello", Value="1" ))   
If DropDownList1.Items.FindByValue("2") IsNot Nothing Then   
    Response.Write("Found")   
End If  
this.DropDownList1.Items.Add(new ListItem{ Text="Hello", Value="1" });  
if(DropDownList1.Items.FindByValue("2") != null) {  
    Response.Write("Found");  
}  

Gilt für:

Siehe auch