Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ListControl.SelectedValue propriété

 

Date de publication : novembre 2016

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.

Espace de noms:   System.Web.UI.WebControls
Assembly:  System.Web (dans System.Web.dll)

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

Valeur de propriété

Type: System.String

Valeur de l'élément sélectionné dans le contrôle de liste. La valeur par défaut est une chaîne vide ("").

Exception Condition
ArgumentOutOfRangeException

La valeur sélectionnée est pas dans la liste des valeurs disponibles et l’état d’affichage ou autre état a été chargé (une publication a été exécutée). Pour plus d'informations, consultez la section Remarques.

Cette propriété retourne le Value propriété du ListItem. Le SelectedValue propriété est couramment utilisée pour déterminer la valeur de l’élément sélectionné dans le contrôle de liste. 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. Si aucun élément n’est sélectionné, une chaîne vide (« ») est retournée.

Le 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.

Cette propriété ne peut pas être définie par les thèmes ou thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET Themes and Skins.

Lorsque la valeur sélectionnée n’est pas dans la liste des valeurs disponibles et une publication (postback) est exécutée, une ArgumentOutOfRangeException exception est levée. L’exemple suivant montre comment intercepter une valeur non valide avant la publication (postback) se produit :

this.DropDownList1.Items.Add(new ListItem{ Text="Hello", Value="1" });
if(DropDownList1.Items.FindByValue("2") != null) {
    Response.Write("Found");
}

L’exemple suivant montre comment utiliser le SelectedValue propriété pour sélectionner un élément dans un ListBox contrôle. Notez que cette propriété peut également être utilisée pour récupérer la valeur de l’élément sélectionné.

System_CAPS_security Sécurité Remarque

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. 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. Pour plus d'informations, consultez 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>

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: