次の方法で共有

ListControl.SelectedValue プロパティ

  • [アーティクル]

リスト コントロール内の選択されている項目の値を取得します。または、指定した値が含まれるリスト コントロール内の項目を選択します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)

構文

'宣言
<BindableAttribute(True, BindingDirection.TwoWay)> _
<ThemeableAttribute(False)> _
Public Overridable Property SelectedValue As String
'使用
Dim instance As ListControl
Dim value As String

value = instance.SelectedValue

instance.SelectedValue = value

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

[BindableAttribute(true, BindingDirection::TwoWay)] 
[ThemeableAttribute(false)] 
public:
virtual property String^ SelectedValue {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_SelectedValue ()

/** @property */
public void set_SelectedValue (String value)

public function get SelectedValue () : String

public function set SelectedValue (value : String)

適用できません。

プロパティ値

リスト コントロール内の選択されている項目の値。既定値は空の文字列 ("") です。

例外

例外の種類 条件

ArgumentOutOfRangeException

選択した値が、使用できる値のリストに含まれていません。

解説

このプロパティは、選択した ListItem の Value プロパティを返します。SelectedValue プロパティは、通常、リスト コントロール内で選択されている項目の値を確認するときに使用します。複数の項目が選択されている場合は、最小のインデックスを持つ選択項目の値が返されます。項目が選択されていない場合は、空の文字列 ("") が返されます。

また、項目の値を使用して SelectedValue プロパティを設定すると、このプロパティでリスト コントロールの項目を選択することもできます。指定した値を含む項目がリスト コントロール内にない場合は、System.ArgumentOutOfRangeException がスローされます。

このプロパティは、テーマ別またはスタイル シート テーマ別に設定することはできません。詳細については、ThemeableAttribute のトピックおよび「ASP.NET のテーマとスキンの概要」を参照してください。

使用例

SelectedValue プロパティを使用して、ListBox コントロール内の項目を選択する方法を次の例に示します。このプロパティを使用すると、選択されている項目の値を取得することもできます。

セキュリティに関するメモセキュリティに関するメモ :

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは 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>

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

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1

参照

関連項目

ListControl クラス
ListControl メンバ
System.Web.UI.WebControls 名前空間
ListControl.SelectedItem プロパティ
ListControl.SelectedIndex プロパティ
ListControl.DataValueField プロパティ
ListControl.Items プロパティ
ListItem
System.ArgumentOutOfRangeException