ListControl.SelectedValue Propiedad

Definición

Obtiene el valor del elemento seleccionado en el control de lista o selecciona el elemento en el control de lista que contiene el valor especificado.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

Valor de propiedad

Valor del elemento seleccionado en el control de lista.The value of the selected item in the list control. El valor predeterminado es una cadena vacía ("").The default is an empty string ("").

Atributos

Excepciones

El valor seleccionado no está en la lista de valores disponibles y estado de vista, o se ha cargado otro estado (se ha realizado un postback).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).

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar SelectedValue la propiedad para seleccionar un elemento de ListBox un control.The following example demonstrates how to use the SelectedValue property to select an item in a ListBox control. Tenga en cuenta que esta propiedad también se puede utilizar para recuperar el valor del elemento seleccionado.Notice that this property can also be used to retrieve the value of the selected item.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.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>

Comentarios

Esta propiedad devuelve la Value propiedad del seleccionado. ListItemThis property returns the Value property of the selected ListItem. La SelectedValue propiedad se utiliza normalmente para determinar el valor del elemento seleccionado en el control de lista.The SelectedValue property is commonly used to determine the value of the selected item in the list control. Si se seleccionan varios elementos, se devuelve el valor del elemento seleccionado con el índice inferior.If multiple items are selected, the value of the selected item with the lowest index is returned. Si no hay ningún elemento seleccionado, se devuelve una cadena vacía ("").If no item is selected, an empty string ("") is returned.

La SelectedValue propiedad también se puede utilizar para seleccionar un elemento del control de lista estableciéndolo con el valor del elemento.The SelectedValue property can also be used to select an item in the list control by setting it with the value of the item.

Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos.This property cannot be set by themes or style sheet themes. Para obtener más información, ThemeableAttribute vea y temas y máscaras de ASP.net.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Cuando el valor seleccionado no está en la lista de valores disponibles y se realiza un postback, ArgumentOutOfRangeException se produce una excepción.When the selected value is not in the list of available values and a postback is performed, an ArgumentOutOfRangeException exception is thrown. En el ejemplo siguiente se muestra cómo detectar un valor no válido antes de que se produzca el PostBack: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");  
}  

Se aplica a

Consulte también: