ListControl.SelectedValue Propriété

Définition

Obtient la valeur de l'élément sélectionné dans le contrôle de liste ou sélectionne, dans ce contrôle, l'élément qui contient la valeur spécifiée.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

Valeur de propriété

Valeur de l'élément sélectionné dans le contrôle de liste.The value of the selected item in the list control. La valeur par défaut est une chaîne vide ("").The default is an empty string ("").

Attributs

Exceptions

La valeur sélectionnée ne figure pas dans la liste de valeurs disponibles, et l'état d'affichage ou un autre état a été chargé (une publication a été exécutée).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).

Exemples

L’exemple suivant montre comment utiliser la SelectedValue propriété pour sélectionner un élément dans un ListBox contrôle.The following example demonstrates how to use the SelectedValue property to select an item in a ListBox control. Notez que cette propriété peut également être utilisée pour récupérer la valeur de l’élément sélectionné.Notice that this property can also be used to retrieve the value of the selected item.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité.This example has a text box that accepts user input, which is a potential security threat. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.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>

Remarques

Cette propriété retourne la Value propriété du sélectionné. ListItemThis property returns the Value property of the selected ListItem. La SelectedValue propriété est couramment utilisée pour déterminer la valeur de l’élément sélectionné dans le contrôle de liste.The SelectedValue property is commonly used to determine the value of the selected item in the list control. Si plusieurs éléments sont sélectionnés, la valeur de l’élément sélectionné avec l’index le plus bas est retournée.If multiple items are selected, the value of the selected item with the lowest index is returned. Si aucun élément n’est sélectionné, une chaîne vide ("") est retournée.If no item is selected, an empty string ("") is returned.

La SelectedValue propriété peut également être utilisée pour sélectionner un élément dans le contrôle de liste en lui affectant la valeur de l’élément.The SelectedValue property can also be used to select an item in the list control by setting it with the value of the item.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style.This property cannot be set by themes or style sheet themes. Pour plus d’informations, ThemeableAttribute consultez et thèmes et apparences ASP.net.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Lorsque la valeur sélectionnée ne figure pas dans la liste des valeurs disponibles et qu’une publication (postback ArgumentOutOfRangeException ) est effectuée, une exception est levée.When the selected value is not in the list of available values and a postback is performed, an ArgumentOutOfRangeException exception is thrown. L’exemple suivant montre comment intercepter une valeur non valide avant que la publication (postback) se produise :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");  
}  

S’applique à

Voir aussi