Microsoft KB Archive/312489

= How to add static items and results from data binding to a DropDownList control by using Visual C# .NET =

Article ID: 312489

Article Last Modified on 4/19/2007

-

APPLIES TO


 * Microsoft ASP.NET 1.1
 * Microsoft Visual C# .NET 2003 Standard Edition
 * Microsoft ASP.NET 1.0
 * Microsoft Visual C# .NET 2002 Standard Edition

-



This article was previously published under Q312489





For a Microsoft Visual Basic .NET version of this article, see 314334.

This article refers to the following Microsoft .NET Framework Class Library namespace:
 * System.Data.SqlClient



SUMMARY
This article demonstrates how to add static items and data-bound items to a DropDownList control. The sample in this article populates a DropDownList control with an initial item.

Requirements
The following list outlines the recommended hardware, software, network infrastructure, and service packs that you need:
 * Microsoft Windows 2000 Professional, Microsoft Windows 2000 Server, Microsoft Windows 2000 Advanced Server, or Microsoft Windows XP
 * Microsoft .NET Framework
 * Microsoft Visual Studio .NET
 * Microsoft Internet Information Services (IIS)
 * Microsoft SQL Server



Create an ASP.NET Web application by using Visual C# .NET
To create a new ASP.NET Web application that is named DDLSample, follow these steps:
 * 1) Open Microsoft Visual Studio .NET.
 * 2) On the File menu, point to New, and then click Project.
 * 3) In the New Project dialog box, click Visual C# Projects under Project Types, and then click ASP.NET Web Application under Templates.
 * 4) In the Location box, replace WebApplication1 in the default URL with DDLSample . If you are using the local server, you can leave the server name as http://localhost so that the Location box displays http://localhost/DDLSample.

Create the sample
In the following steps, you create an .aspx page that contains a DropDownList control. The DropDownList control is data bound to columns of the Authors table from the SQL Server Pubs database.  To add a Web Form to the project, follow these steps:  Right-click the project node in Solution Explorer, click Add, and then click Add Web Form. Name the .aspx page DropDown.aspx, and then click Open.  Make sure that the page is open in Design view in the editor. Add a DropDownList control to the page. In the Properties pane, change the ID of the control to AuthorList . Add a Label control to the page after the DropDownList control. In the Properties pane, change the ID of the control to CurrentItem .</li> Add a Button control to the page after the Label control. In the Properties pane, change the ID of the control to GetItem, and then change the Text property to Get Item .</li> Right-click the page, and then click View Code. This opens the code-behind class file in the editor.</li>  Add the System.Data.SqlClient namespace to the code-behind class file so that the sample code functions properly. The complete list of namespaces should appear as follows. using System; using System.Collections; using System.ComponentModel; using System.Data; using System.Drawing; using System.Web; using System.Web.SessionState; using System.Web.UI; using System.Web.UI.WebControls; using System.Web.UI.HtmlControls; using System.Data.SqlClient; </li>  Add the following code to the Page_Load event. private void Page_Load(object sender, System.EventArgs e)       { if(!IsPostBack) {               SqlConnection myConn = new SqlConnection(                    &quot;Server=localhost;Database=Pubs;Integrated Security=SSPI&quot;); SqlCommand myCmd = new SqlCommand(                   &quot;SELECT au_id, au_lname FROM Authors&quot;, myConn); myConn.Open; SqlDataReader myReader = myCmd.ExecuteReader; //Set up the data binding. AuthorList.DataSource = myReader; AuthorList.DataTextField = &quot;au_lname&quot;; AuthorList.DataValueField = &quot;au_id&quot;; AuthorList.DataBind; //Close the connection. myConn.Close; myReader.Close;

//Add the item at the first position. AuthorList.Items.Insert(0, &quot;<-- Select -->&quot;); }

} To use Integrated Security in the connect string, change the Web.config file for the application and set the impersonate attribute of the identity configuration element to true, as shown in the following example. <system.web> <identity impersonate=&quot;true&quot; /> </system.web> For more information about ASP.NET Impersonation, visit the following Microsoft Developer Network (MSDN) Web site:

http://msdn2.microsoft.com/en-us/library/xh507fc5(vs.71).aspx

</li> Modify the connection string as appropriate for your environment.</li>  Switch to the Design view in the editor for the .aspx page. Double-click GetItem. Add the following code to the GetItem_Click event in the code-behind class file. private void GetItem_Click(object sender, System.EventArgs e)       { string itemText = AuthorList.SelectedItem.Text; string itemValue = AuthorList.SelectedItem.Value; CurrentItem.Text = string.Format(               &quot;Selected Text is {0}, and Value is {1}&quot;, itemText, itemValue); }                   </li> On the File menu, click Save All to save the Web Form and other associated project files.</li> On the Build menu in the Visual Studio .NET Integrated Development Environment (IDE), click Build to build the project.</li> In Solution Explorer, right-click the .aspx page, and then click View In Browser. Notice that the page opens in the browser and that the drop-down list box is populated with the initial data.</li> Click an item in the drop-down list box. Notice that the CurrentItem Label control displays the item that you selected. In addition, notice that the list retains the current position and the static entry.</li></ol>

Troubleshooting

 * You must place the code to add the static item to the ListItem collection of the control after the data binding code. If you do not add the code in this order, the list is re-created with the data binding code, which overwrites the static entry.
 * The sample code checks the IsPostBack property to prevent the list from being re-created. In addition, this code checks IsPostBack to retain the selected item in the current position of the list between round trips to the server.

<div class="references_section">