ListControl.SelectedValue 속성

정의

목록 컨트롤에서 선택한 항목의 값을 가져오거나, 지정된 값이 포함된 목록 컨트롤에서 항목을 선택합니다.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

속성 값

목록 컨트롤에서 선택한 항목의 값입니다.The value of the selected item in the list control. 기본값은 빈 문자열("")입니다.The default is an empty string ("").

특성

예외

선택한 값이 사용 가능한 값의 목록에 있지 않고 보기 상태 또는 다른 상태가 로드되지 않았습니다. 그리고 포스트백은 수행되었습니다.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).

예제

다음 예제에서는 사용 하는 방법에 설명 합니다 SelectedValue 속성에서 항목을 선택 하는 ListBox 컨트롤입니다.The following example demonstrates how to use the SelectedValue property to select an item in a ListBox control. 선택한 항목의 값을 검색할에이 속성 데도 사용할 수 있습니다를 확인 합니다.Notice that this property can also be used to retrieve the value of the selected item.

중요

이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있으므로 보안상 위험할 수 있습니다.This example has a text box that accepts user input, which is a potential security threat. 기본적으로 ASP.NET 웹 페이지는 사용자 입력 내용에 스크립트 또는 HTML 요소가 포함되어 있지 않은지 확인합니다.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 자세한 내용은 Script Exploits Overview를 참조하세요.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>

설명

이 속성을 반환 합니다 Value 선택한 속성 ListItem합니다.This property returns the Value property of the selected ListItem. SelectedValue 속성은 일반적으로 목록 컨트롤에서 선택한 항목의 값을 확인 하는 데 사용 됩니다.The SelectedValue property is commonly used to determine the value of the selected item in the list control. 여러 항목이 선택 되 면 가장 낮은 인덱스를 사용 하 여 선택한 항목의 값이 반환 됩니다.If multiple items are selected, the value of the selected item with the lowest index is returned. 선택은 항목이 없으면 빈 문자열 ("")이 반환 됩니다.If no item is selected, an empty string ("") is returned.

SelectedValue 속성 항목의 값으로 설정 하 여 목록 컨트롤에서 항목을 선택 하 여 사용할 수도 있습니다.The SelectedValue property can also be used to select an item in the list control by setting it with the value of the item.

이 속성은 테마 또는 스타일시트 테마에 의해 설정될 수 없습니다.This property cannot be set by themes or style sheet themes. 자세한 내용은 ThemeableAttribute 하 고 ASP.NET 테마 및 스킨합니다.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

선택한 값에 사용 가능한 값 목록을 없고 포스트백을 수행 하는 경우는 ArgumentOutOfRangeException 예외가 throw 됩니다.When the selected value is not in the list of available values and a postback is performed, an ArgumentOutOfRangeException exception is thrown. 다음 예제에서는 포스트백 발생 하기 전에 잘못 된 값을 catch 하는 방법을 보여 줍니다.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");  
}  

적용 대상

추가 정보