Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Proprietà ListControl.SelectedValue

 

Data di pubblicazione: ottobre 2016

Ottiene il valore dell'elemento selezionato nell'elenco o seleziona l'elemento nell'elenco che contiene il valore specificato.

Spazio dei nomi:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

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

Valore proprietà

Type: System.String

Valore dell'elemento selezionato nell'elenco. Il valore predefinito è una stringa vuota ("").

Exception Condition
ArgumentOutOfRangeException

Il valore selezionato non è in elenco di valori disponibili e lo stato di visualizzazione o altro stato è stato caricato (è stato eseguito un postback). Per altre informazioni, vedere la sezione Osservazioni.

Questa proprietà restituisce il Value proprietà dell'oggetto selezionato ListItem. Il SelectedValue proprietà viene generalmente utilizzata per determinare il valore dell'elemento selezionato nel controllo elenco. Se vengono selezionati più elementi, viene restituito il valore dell'elemento selezionato con l'indice più basso. Se è selezionato alcun elemento, una stringa vuota ("") viene restituito.

Il SelectedValue proprietà può anche essere utilizzata per selezionare un elemento nel controllo elenco impostandolo con il valore dell'elemento.

Questa proprietà non può essere impostata attraverso l'utilizzo di temi o di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Themes and Skins.

Quando il valore selezionato non è presente nell'elenco dei valori disponibili e viene eseguito un postback, un ArgumentOutOfRangeException viene generata un'eccezione. Nell'esempio seguente viene illustrato come intercettare un valore non valido prima che si verifica il postback:

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

Nell'esempio seguente viene illustrato come utilizzare il SelectedValue proprietà per selezionare un elemento in un ListBox controllo. Si noti che questa proprietà può essere utilizzata anche per recuperare il valore dell'elemento selezionato.

System_CAPS_security Sicurezza Nota

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere 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
Disponibile da 1.1
Torna all'inizio
Mostra: