ListControl.SelectedValue プロパティ

ValueMember プロパティで指定したメンバ プロパティの値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)

構文

'宣言
<BindableAttribute(True)> _
Public Property SelectedValue As Object
'使用
Dim instance As ListControl
Dim value As Object

value = instance.SelectedValue

instance.SelectedValue = value
[BindableAttribute(true)] 
public Object SelectedValue { get; set; }
[BindableAttribute(true)] 
public:
property Object^ SelectedValue {
    Object^ get ();
    void set (Object^ value);
}
/** @property */
public Object get_SelectedValue ()

/** @property */
public void set_SelectedValue (Object value)
public function get SelectedValue () : Object

public function set SelectedValue (value : Object)

プロパティ値

ValueMember プロパティで指定したデータ ソースのメンバの値を格納しているオブジェクト。

例外

例外の種類 条件

InvalidOperationException

代入された値が null 参照 (Visual Basic では Nothing) または空の文字列 ("") です。

解説

ValueMember にプロパティを指定しない場合、SelectedValue はオブジェクトの ToString メソッドの結果を返します。

SelectedIndexSelectedValue、および FormattingEnabled は、次のように関連します。

  • FormattingEnabledfalse で、SelectedValue が空白の場合、SelectedIndex は -1 に設定されません。

  • FormattingEnabledtrue で、SelectedValue が空白の場合、SelectedIndex は -1 に設定されます。

使用例

ValueMember プロパティで指定されたプロパティの値を返す SelectedValue を次のコード例に示します。このコードは、ListControl クラスの概要で紹介されている例からの抜粋です。コード全体については、ListControl を参照してください。

Private Sub ListBox1_SelectedValueChanged(sender As Object, e As EventArgs)
   If ListBox1.SelectedIndex <> - 1 Then
      textBox1.Text = ListBox1.SelectedValue.ToString()
   End If
End Sub 'ListBox1_SelectedValueChanged
private void ListBox1_SelectedValueChanged(object sender, EventArgs e)
{
    if (ListBox1.SelectedIndex != -1)
        textBox1.Text = ListBox1.SelectedValue.ToString();
}
void ListBox1_SelectedValueChanged( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   if ( ListBox1->SelectedIndex != -1 )
         textBox1->Text = ListBox1->SelectedValue->ToString();
}
private void listBox1_SelectedValueChanged(Object sender, EventArgs e)
{
    if (listBox1.get_SelectedIndex() != -1) {
        textBox1.set_Text(listBox1.get_SelectedValue().ToString());
    }
} //listBox1_SelectedValueChanged

プラットフォーム

Windows 98, Windows 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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 2.0、1.1、1.0

.NET Compact Framework

サポート対象 : 2.0、1.0

参照

関連項目

ListControl クラス
ListControl メンバ
System.Windows.Forms 名前空間
ValueMember