ListBox.SelectionMode Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de selectiemodus van het besturingselement op of stelt u deze ListBox in.
public:
virtual property System::Web::UI::WebControls::ListSelectionMode SelectionMode { System::Web::UI::WebControls::ListSelectionMode get(); void set(System::Web::UI::WebControls::ListSelectionMode value); };
public virtual System.Web.UI.WebControls.ListSelectionMode SelectionMode { get; set; }
member this.SelectionMode : System.Web.UI.WebControls.ListSelectionMode with get, set
Public Overridable Property SelectionMode As ListSelectionMode
Waarde van eigenschap
Een van de ListSelectionMode waarden. De standaardwaarde is Single.
Uitzonderingen
De opgegeven selectiemodus is geen van de ListSelectionMode waarden.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de SelectionMode eigenschap gebruikt zodat de gebruiker meerdere selecties in het ListBox besturingselement kan selecteren.
<%@ 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>ListBox Example</title>
<script runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
Message.Text = "You chose: <br />";
// Iterate through the Items collection of the ListBox and
// display the selected items.
foreach (ListItem item in ListBox1.Items)
{
if(item.Selected)
{
Message.Text += item.Text + "<br />";
}
}
}
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
Select items from the list and click Submit. <br />
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
SelectionMode="Multiple"
runat="server">
<asp:ListItem Selected="True">Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:ListBox>
<br /><br />
<asp:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<br /><br />
<asp:Label id="Message"
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>ListBox Example</title>
<script runat="server">
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
Message.Text = "You chose: <br />"
' Iterate through the Items collection of the ListBox and
' display the selected items.
Dim item As ListItem
For Each item in ListBox1.Items
If item.Selected Then
Message.Text &= item.Text & "<br />"
End If
Next
End Sub
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
Select items from the list and click Submit. <br />
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
SelectionMode="Multiple"
runat="server">
<asp:ListItem Selected="True">Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:ListBox>
<br /><br />
<asp:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<br /><br />
<asp:Label id="Message"
runat="server"/>
</form>
</body>
</html>
Opmerkingen
Gebruik de SelectionMode eigenschap om het gedrag van de modus van het ListBox besturingselement op te geven. Als u deze eigenschap instelt om aan te ListSelectionMode.Single geven dat slechts één item kan worden geselecteerd in het ListBox besturingselement, terwijl ListSelectionMode.Multiple er meerdere items kunnen worden geselecteerd.
De waarde van de SelectionMode eigenschap wordt opgeslagen in de weergavestatus.