The ASP.NET Development Server
Iron Speed Designer can run your application using either ASP.NET Development Server or the Microsoft Internet Information Server (IIS).
Downloading the ASP.NET Development Server
The ASP.NET Development Server is installed as part of the following products from Microsoft:
-
Microsoft Visual Studio 2005 or 2008
-
Microsoft Visual Web Developer Express Edition 2005 or 2008 (Free Download at http://www.asp.net/downloads/essential/)
In both cases, the ASP.NET Development Server is installed in the Microsoft .NET Framework Version 2.0 folder (e.g., C:\Windows\Microsoft.NET\Framework\v2.0.50727). To verify if the ASP.NET Development Server is installed, you can check whether the following two files are present in the v2.0.50727 folder of the Microsoft .NET Framework:
-
WebDev.WebServer.EXE
-
WebDev.WebServer.exe.manifest
Please note that the ASP.NET Development Server is not included with the redistributable version of the Microsoft .NET Framework even though the files are installed in the .NET Framework folder.
Installing the ASP.NET Development Server
In certain cases, the ASP.NET Development Server may have been installed in a different location than the Microsoft .NET Framework folder. Possible locations include:
-
C:\Windows\Microsoft.NET\Framework\v2.0.50727
-
C:\Program Files\Microsoft Shared\DevServer\9.0
-
C:\Program Files\Common Files\Microsoft Shared\DevServer\9.0
-
C:\Program Files (x86)\Common Files\Microsoft Shared\DevServer\9.0
-
C:\Program Files (x86)\Microsoft Shared\DevServer\9.0
Iron Speed Designer currently only recognizes the presence of the ASP.NET Development Server in the Microsoft .NET Framework folder. If the ASP.NET Development Server does not start, you can copy the server files into the Microsoft .NET Framework folder from one of the other locations.
The two files that make up the ASP.NET Development Server are:
-
WebDev.WebServer.EXE
-
WebDev.WebServer.exe.manifest
Search for these two files in the Program Files folders in the list above and copy them into:
C:\Windows\Microsoft.NET\Framework\v2.0.50727
After you restart Iron Speed Designer, your application should be able to start using the ASP.NET Development Server.
Using ASP.NET Development Server
In Iron Speed Designer you can test your ASP.NET pages by using the ASP.NET Development Server or Microsoft IIS. The ASP.NET Development Server is the default Web server in Iron Speed Designer as long as it is available on your computer. It is a Web server that runs locally on most of the Windows operating systems, including Windows XP Home Edition. It is specifically built to serve, or run, ASP.NET Web pages under the local host scenario (browsing from the same computer as the Web server). In other words, the ASP.NET Development Server will serve pages to browser requests on the local computer. It will not serve pages to another computer. Additionally, it will not serve files that are outside of the application scope. The ASP.NET Development Server provides an efficient way to test pages locally before you publish the pages to a production server running IIS.
You can change the Web server selection before running an application in Iron Speed Designer using the Build menu. Once you select a Web server, that server will be your default. However, you cannot select a Web server if it is not installed on your machine. The ASP.NET Development Server automatically selects a free port to run your application. You can force the server to use a specific port as explained later.
For more information see: Web Servers in Visual Web Developer at: http://msdn.microsoft.com/en-us/library/58wxa9w5(VS.80).aspx
Selecting the default web server
You can select the default web server used by Iron Speed Designer in the Build Menu.
Once you have changed the selection in the menu, that choice becomes your default and is saved in your Designer.config file. This will be used each time you start Iron Speed Designer, until it is changed again. However, if your default web server is no longer installed on your machine, Iron Speed Designer will automatically change to the other server. If there is no web server on your machine, you will still be able to build your application, but it will not run.
What happens when I run my application using the ASP.NET Development Server?
After your application is built, ASP.NET Development Server is started with the folder containing your application as the input. The server will select a free port on your machine and create a browser window containing your application at that port. At this point, you can interact with your application in the browser. The running server will appear as an icon in your system tray.
Your browser will show the start page of your running application.
If you close your application in the browser, or close the browser, the server remains running in your system tray. If you close the development server, the browser will remain open. This means that any web page in the browser will get an error when it tries to refer to a server which no longer exists. The server is closed by Iron Speed Designer when the application is closed.
If you open multiple applications in Iron Speed Designer, multiple versions of ASP.NET Development Servers will be started, each on their own port.
Selecting the port for the ASP.NET Development Server
If you want to run the ASP.NET Development Server on a specific port, you can configure Iron Speed Designer to do so. In your Designer.config file, add a key for DevelopmentServerPort, with a value of the port number to be assigned, e.g.:
<add key="DevelopmentServerPort" value="1873" />
If you do specify a specific port, Iron Speed Designer cannot guarantee that the port you specify will be available when you run your file-system Web site.