This documentation is archived and is not being maintained.
ListBox.Rows Property
.NET Framework 1.1
Gets or sets the number of rows displayed in the ListBox control.
[Visual Basic] Public Overridable Property Rows As Integer [C#] public virtual int Rows {get; set;} [C++] public: __property virtual int get_Rows(); public: __property virtual void set_Rows(int); [JScript] public function get Rows() : int; public function set Rows(int);
Property Value
The number of rows displayed in the ListBox control. The default value is 4.
Exceptions
| Exception Type | Condition |
|---|---|
| ArgumentOutOfRangeException | The specified number of rows is less than one or greater than 2000. |
Remarks
Use the Rows property to specify the number of rows to display in the ListBox control.
CAUTION The number of rows must be between one and 2000. Values outside of this range will raise an exception.
Example
[Visual Basic, C#, JScript] The following example demonstrates how to use the Rows property to display six rows in the ListBox control.
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script language="VB" runat="server"> Sub SubmitBtn_Click(sender As Object, e As EventArgs) If ListBox1.SelectedIndex > -1 Then Label1.Text = "You chose: " & ListBox1.SelectedItem.Text End If End Sub </script> </head> <body> <h3>ListBox Example</h3> <form runat=server> <asp:ListBox id="ListBox1" Rows="6" Width="100px" SelectionMode="Single" 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:ListItem>Item 5</asp:ListItem> <asp:ListItem>Item 6</asp:ListItem> </asp:ListBox> <asp:button id="Button1" Text="Submit" OnClick="SubmitBtn_Click" runat="server" /> <asp:Label id="Label1" Font-Name="Verdana" Font-Size="10pt" runat="server"/> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script language="C#" runat="server"> void SubmitBtn_Click(Object sender, EventArgs e) { if (ListBox1.SelectedIndex > -1) Label1.Text="You chose: " + ListBox1.SelectedItem.Text; } </script> </head> <body> <h3>ListBox Example</h3> <form runat=server> <asp:ListBox id="ListBox1" Rows="6" Width="100px" SelectionMode="Single" 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:ListItem>Item 5</asp:ListItem> <asp:ListItem>Item 6</asp:ListItem> </asp:ListBox> <asp:button id="Button1" Text="Submit" OnClick="SubmitBtn_Click" runat="server" /> <asp:Label id="Label1" Font-Name="Verdana" Font-Size="10pt" runat="server"/> </form> </body> </html> [JScript] <%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> <script language="JSCRIPT" runat="server"> function SubmitBtn_Click(sender : Object, e : EventArgs) { if(ListBox1.SelectedIndex > -1){ Label1.Text = "You chose: " + ListBox1.SelectedItem.Text } } </script> </head> <body> <h3>ListBox Example</h3> <form runat=server> <asp:ListBox id="ListBox1" Rows="6" Width="100px" SelectionMode="Single" 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:ListItem>Item 5</asp:ListItem> <asp:ListItem>Item 6</asp:ListItem> </asp:ListBox> <asp:button id="Button1" Text="Submit" OnClick="SubmitBtn_Click" runat="server" /> <asp:Label id="Label1" Font-Name="Verdana" Font-Size="10pt" runat="server"/> </form> </body> </html>
[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
ListBox Class | ListBox Members | System.Web.UI.WebControls Namespace
Show: