HtmlSelect.Value Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Obtient la valeur de l'élément sélectionné dans le contrôle HtmlSelect ou définit la propriété SelectedIndex du contrôle sur l'index du premier élément de la liste comportant la valeur spécifiée.

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

Valeur de propriété

String

Valeur de l'élément sélectionné dans le contrôle HtmlSelect. Si aucun élément n'est sélectionné dans le contrôle, Empty est retourné.

Exceptions

ArgumentOutOfRangeException

La propriété Value a un nombre d'éléments supérieur au nombre d'éléments contenus dans le contrôle HtmlSelect ou inférieur à -1.

Exemples

L’exemple de code suivant montre comment utiliser la Value propriété pour obtenir la valeur de l’élément sélectionné dans le HtmlSelect contrôle.


<%@ 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>

Remarques

La Value propriété est couramment utilisée pour obtenir la valeur de l’élément référencé par la SelectedIndex propriété .

Notes

Si aucun élément n'est sélectionné dans le contrôle, String.Empty est retourné.

Si vous définissez cette propriété sur une valeur, la SelectedIndex propriété est mise à jour avec l’index du premier élément de la liste qui contient cette valeur. Si aucune valeur correspondante n’est trouvée, la SelectedIndex propriété reste inchangée.

S’applique à

Voir aussi