ListControl.SelectedValue Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o valor da propriedade do membro especificado pela propriedade ValueMember.

public:
 property System::Object ^ SelectedValue { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Browsable(false)]
public object SelectedValue { get; set; }

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Browsable(false)]
public object? SelectedValue { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.Browsable(false)>]
member this.SelectedValue : obj with get, set

Public Property SelectedValue As Object

Valor da propriedade

Object

Um objeto que contém o valor do membro da fonte de dados especificada pela propriedade ValueMember.

Atributos

BindableAttribute BrowsableAttribute

Exceções

InvalidOperationException

O valor atribuído é null ou a cadeia de caracteres vazia ("").

Exemplos

O exemplo de código a seguir mostra o SelectedValue retorno do valor da propriedade especificada pela ValueMember propriedade. Esse código é um trecho do exemplo mostrado na visão geral da ListControl classe. Consulte ListControl toda a listagem de código.

void ListBox1_SelectedValueChanged( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   textBox1->Text="";
   if ( ListBox1->SelectedIndex != -1 )
         textBox1->Text = ListBox1->SelectedValue->ToString();
}

private void ListBox1_SelectedValueChanged(object sender, EventArgs e)
{
    if (ListBox1.SelectedIndex != -1)
    {
        textBox1.Text = ListBox1.SelectedValue.ToString();
        // If we also wanted to get the displayed text we could use
        // the SelectedItem item property:
        // string s = ((USState)ListBox1.SelectedItem).LongName;
    }
}

    Private Sub ListBox1_SelectedValueChanged(ByVal sender As Object, ByVal e As EventArgs)
        If ListBox1.SelectedIndex <> -1 Then
            textBox1.Text = ListBox1.SelectedValue.ToString()
            ' If we also wanted to get the displayed text we could use
            ' the SelectedItem item property:
            ' Dim s = CType(ListBox1.SelectedItem, USState).LongName
        End If
    End Sub
End Class

Comentários

Se uma propriedade não for especificada, ValueMemberSelectedValue retornará os resultados do ToString método do objeto.

SelectedIndex, SelectedValuee FormattingEnabled estão relacionados da seguinte maneira:

• Se FormattingEnabled for false, SelectedIndex não será definido como -1 quando SelectedValue estiver em branco.

• Se FormattingEnabled for true, SelectedIndex será definido como -1 quando SelectedValue estiver em branco.

Confira também

• ValueMember