|
1 | 1 | --- |
2 | | -title: Deploy applications built on .NET Framework |
3 | | -description: This article describes important considerations for deploying applications that are built on the .NET Framework. |
| 2 | +title: Deploy Applications Built on .NET Framework |
| 3 | +description: This article discusses important considerations for deploying applications that are built on .NET Framework. |
4 | 4 | ms.date: 07/07/2025 |
5 | 5 | ms.custom: sap:Installation and Deployment |
6 | 6 | ms.topic: how-to |
7 | 7 |
|
8 | 8 | #customer intent: As a developer, I want to deploy my .NET Framework application so that it's accessible to my users. |
9 | 9 | --- |
10 | | -# Deploy applications that are built on the .NET Framework |
| 10 | +# Deploy applications that are built on .NET Framework |
11 | 11 |
|
12 | | -This article describes important considerations for deploying applications that are built on the .NET Framework. |
13 | | - |
14 | | -For important considerations when securing applications that are built on the .NET Framework, see the related [Secure applications that are built on the .NET Framework](/troubleshoot/developer/dotnet/framework/general/secure-applications). |
| 12 | +This article discusses important considerations for deploying applications that are built on .NET Framework. For information about how to secure applications that are built on .NET Framework, see [Secure applications that are built on the .NET Framework](/troubleshoot/developer/dotnet/framework/general/secure-applications). |
15 | 13 |
|
16 | 14 | _Applies to:_ .NET Framework |
17 | 15 |
|
18 | 16 | _Original KB number:_ 818016 |
19 | 17 |
|
20 | | -## Create the Web.Config file for an ASP.NET application |
| 18 | +## Web.Config file for an ASP.NET application |
21 | 19 |
|
22 | | -The `Web.config` file is an XML file that contains application-specific settings that override system defaults. While most ASP applications that are built on the .NET Framework are deployed with a `Web.config` file, the `Web.config` file is optional. You may have to create a `Web.config` file to override default settings on an application-by-application basis. |
| 20 | +The `Web.config` file is an XML file that contains application-specific settings that override system defaults. Although most ASP applications that are built on .NET Framework are deployed by having a `Web.config` file, the `Web.config` file is optional. You may have to create a `Web.config` file to override default settings on an application-by-application basis. |
23 | 21 |
|
24 | | -For more information about how to create a `Web.config` file for an application that doesn't already have one, visit [Edit the configuration of an ASP.NET application](/troubleshoot/developer/webapps/aspnet/development/edit-web-config). |
| 22 | +For more information about how to create a `Web.config` file for an application that doesn't already have one, see [Edit the configuration of an ASP.NET application](/troubleshoot/developer/webapps/aspnet/development/edit-web-config). |
25 | 23 |
|
26 | | -## Edit the configuration of an ASP.NET application |
| 24 | +## Configure an ASP.NET application |
27 | 25 |
|
28 | | -All systems where the .NET Framework has been deployed have system-wide ASP.NET configuration settings that are defined in the `<system.web>` element of the `Machine.config` file. You can modify these settings (frequently, you must modify these settings) on an application-by-application basis. |
| 26 | +All systems on which .NET Framework is deployed have system-wide ASP.NET configuration settings that are defined in the `<system.web>` element of the `Machine.config` file. You can modify these settings on an application-by-application basis. In fact, such a modification is frequently necessary. |
29 | 27 |
|
30 | 28 | For more information about how to override .NET framework default configuration settings for a specific application, see [Edit the configuration of an ASP.NET application](/troubleshoot/developer/webapps/aspnet/development/edit-web-config). |
31 | 29 |
|
32 | | -## Determine if a client system meets the minimum requirements for installing the .NET Framework |
| 30 | +## Minimum client installation requirements |
| 31 | + |
| 32 | +Before you can deploy applications that are built on .NET Framework to a client system, that system must have specific software components and updates installed. Most client systems meet the requirements. However, you might have to manually verify that a specific system is ready to receive the .NET Framework redistributable. |
33 | 33 |
|
34 | | -Before you can deploy applications that are built on the .NET Framework to a client system, that system must have specific software components and patches installed. Most client systems meet the requirements. However, you may have to manually verify that a specific system is ready to receive the .NET Framework redistributable. |
| 34 | +## Minimum server installation requirements |
35 | 35 |
|
36 | | -## Determine if a server system meets the minimum requirements for installing the .NET Framework |
| 36 | +Before you can deploy applications that are built on .NET Framework to a server, the server must have specific software components and updates installed. Most server systems meet the requirements. However, you might have to manually verify that a specific system is ready to receive the .NET Framework redistributable. |
37 | 37 |
|
38 | | -Before you can deploy applications that are built on the .NET Framework to a server, the server must have specific software components and patches installed. Most server systems meet the requirements. However, you may have to manually verify that a specific system is ready to receive the .NET Framework redistributable. |
| 38 | +## Enable and disable ASP.NET functionality in IIS |
39 | 39 |
|
40 | | -## Selectively enable and disable ASP.NET functionality in IIS |
| 40 | +When .NET Framework is installed on a server that's running Internet Information Services (IIS), ASP.NET is automatically enabled for virtual servers. However, you might not want this configuration. As new ASP Web applications that are built on .NET Framework are deployed to a server that's running IIS 5.0, you can control which virtual servers and directories support ASP.NET and which virtual servers don't. |
41 | 41 |
|
42 | | -When the .NET Framework is installed on a server computer running Internet Information Services (IIS), ASP.NET is automatically enabled for virtual servers. However, you might not want this configuration. As new ASP Web applications that are built on the .NET Framework are deployed to a server computer running IIS 5.0, you can control which virtual servers and directories support ASP.NET and which virtual servers don't. |
| 42 | +For more information about how to enable and disable ASP.NET functionality for virtual servers and directories in IIS 5.0, see [Plan an ASP.NET Website on IIS](/iis/application-frameworks/scenario-build-an-aspnet-website-on-iis/plan-an-asp-net-website-on-iis). |
43 | 43 |
|
44 | | -For additional information about how to enable and disable ASP.NET functionality for virtual servers and directories in IIS 5.0, visit [Plan an ASP.NET Website on IIS](/iis/application-frameworks/scenario-build-an-aspnet-website-on-iis/plan-an-asp-net-website-on-iis). |
| 44 | +## Custom error messages |
45 | 45 |
|
46 | | -## Configure custom error messages for an ASP.NET application |
| 46 | +Many sites change IIS default error message to display a user-friendly page or to notify an administrator. If a server that runs IIS 5.0 has custom error messages, and an ASP Web application that is built on .NET Framework is deployed to that server, errors in the ASP.NET application don't use IIS 5.0 custom error messages unless the application is configured to do this. |
47 | 47 |
|
48 | | -Many sites change IIS default error message to display a user-friendly page or to notify an administrator. When a server computer running IIS 5.0 has custom error messages, and an ASP Web application that is built on the .NET Framework is deployed to that server computer, errors in the ASP.NET application don't use IIS 5.0 custom error messages unless the application is configured to do so. |
| 48 | +For more information about how to configure custom error messages for ASP applications that are built on .NET Framework, see [Create custom error reporting pages in ASP.NET by using Visual Basic .NET](/troubleshoot/developer/webapps/aspnet/development/custom-error-reporting-page). |
49 | 49 |
|
50 | | -For additional information about how to configure custom error messages for ASP applications built on the .NET Framework, visit [Create custom error reporting pages in ASP.NET by using Visual Basic .NET](/troubleshoot/developer/webapps/aspnet/development/custom-error-reporting-page). |
| 50 | +## Application-specific and directory-specific configuration settings |
51 | 51 |
|
52 | | -## Make application-specific and directory-specific configuration settings in an ASP.NET application |
| 52 | +The most common way to override system defaults for a whole ASP.NET application is to create or edit a `Web.config` file for that application. However, configuration changes often must apply only to specific files or folders in an application. You have two methods to limit the scope of configuration changes: |
53 | 53 |
|
54 | | -The most common way to override system defaults for a whole ASP.NET application is to create or edit a `Web.config` file for that application. However, configuration changes frequently must apply only to specific files or folders in an application. There are two ways to limit the scope of configuration changes: |
| 54 | +- Add the `<location>` configuration element to the `Machine.config` file or the `Web.config` file |
55 | 55 |
|
56 | | -- Add the `<location>` configuration element to the `Machine.config` file or the `Web.config` file. |
| 56 | +- Add additional `Web.config` files to subfolders |
57 | 57 |
|
58 | | -- Add additional `Web.config` files to subfolders. For additional information about how to apply changes that affect specific applications and directories, visit [Make application and directory-specific configuration settings in an ASP.NET application](/troubleshoot/developer/webapps/aspnet/development/application-directory-configuration). |
| 58 | +For more information about how to apply changes that affect specific applications and directories, see [Make application and directory-specific configuration settings in an ASP.NET application](/troubleshoot/developer/webapps/aspnet/development/application-directory-configuration). |
59 | 59 |
|
60 | | -## Configure session state management for ASP.NET applications |
| 60 | +## Configure session state management |
61 | 61 |
|
62 | | -ASP.NET has new features for session state management. Session state settings in ASP.NET are configured through the `Web.config` file of an ASP.NET application. Several sessions state management options are available in ASP.NET. These options include mode (inproc, State Server, SQL Server), cookieless state management, out-of process mode state server, and the port settings. |
| 62 | +ASP.NET has new features for session state management. Session state settings in ASP.NET are configured through the `Web.config` file of an ASP.NET application. Several sessions state management options are available in ASP.NET. These options include mode (inproc, State Server, SQL Server), cookieless state management, out-of-process mode state server, and port settings. |
63 | 63 |
|
64 | | -For more information about ASP.NET Session State Management, visit [ASP.NET Session State](/previous-versions/dotnet/articles/ms972429(v=msdn.10)). |
| 64 | +For more information about ASP.NET session state management, see [ASP.NET Session State](/previous-versions/dotnet/articles/ms972429(v=msdn.10)). |
65 | 65 |
|
66 | 66 | ## Build and deploy a .NET security policy deployment package |
67 | 67 |
|
68 | | -The .NET Framework introduces *security policy*. The security policy is a new way to control the resources that an application can gain access to on a system. It defines an application's authorization based on the application's location or source. As an administrator, you can control security policy on a computer-by-computer basis. However, you can use deployment packages as a more scalable method for deploying and managing security policies in Active Directory environments. |
| 68 | +.NET Framework introduces *security policy* to control the resources that an application can use to gain access to a system. Security policy defines an application's authorization based on the application's location or source. As an administrator, you can control security policy on a computer-by-computer basis. However, you can use deployment packages as a more scalable method for deploying and managing security policies in Active Directory environments. |
69 | 69 |
|
70 | 70 | ## Migrate an ASP web application to ASP.NET while retaining existing file names |
71 | 71 |
|
72 | | -ASP.NET offers many benefits over the earlier ASP 3.0 scripting environment. Specifically, ASP applications that are built on the .NET Framework offer improved performance, scalability, and reliability. As a result, many new ASP applications that are built on the .NET Framework are actually upgrades to existing ASP 3.0 applications. |
| 72 | +ASP.NET offers many benefits over the earlier ASP 3.0 scripting environment. Specifically, ASP applications that are built on .NET Framework offer improved performance, scalability, and reliability. Therefore, many new ASP applications that are built on .NET Framework are actually upgrades to existing ASP 3.0 applications. |
73 | 73 |
|
74 | | -One of the challenges of upgrading an application from ASP 3.0 to ASP.NET is that the two environments use different file name extensions. By default, ASP 3.0 uses .asp file name extensions. However, ASP.NET uses .aspx file name extensions. Although the different file name extensions permit the two applications to be located in a single folder, they require bookmarks and hyperlinks to be changed before the ASP 3.0 application is taken offline. |
| 74 | +One of the challenges to upgrade an application from ASP 3.0 to ASP.NET is that the two environments use different file name extensions. By default, ASP 3.0 uses ".asp" and ASP.NET uses ".aspx." Although the different file name extensions permit the two applications to be located in a single folder, they require that you change bookmarks and hyperlinks before the ASP 3.0 application can be taken offline. |
75 | 75 |
|
76 | | -## Configure an ASP.NET application to use the same authentication and authorization as an existing ASP web application |
| 76 | +## Configure an ASP.NET application to use existing authentication and authorization |
77 | 77 |
|
78 | 78 | ASP.NET includes more flexible and sophisticated authentication and authorization systems than ASP 3.0. By default, you can use only Windows authentication to authenticate ASP 3.0 applications. Also, you can control authorization only by using NTFS file permissions. |
79 | 79 |
|
80 | | -ASP.NET supports Windows authentication, and can impersonate the end user in much the same way that ASP 3.0 does. However, by default, this setting isn't enabled. |
| 80 | +ASP.NET supports Windows authentication and can impersonate the user in much the same manner as ASP 3.0 does. By default, however, this setting isn't enabled. |
81 | 81 |
|
82 | 82 | ## Deploy an ASP.NET web application by using XCopy deployment |
83 | 83 |
|
84 | | -You can deploy your ASP.NET web application by using the MS-DOS `xcopy` command-line utility. However, it's a good idea to deploy your project instead of using `xcopy`. As with the Copy Project command, `xcopy` doesn't register or verify the location of assemblies. Also, for web projects, `xcopy` doesn't automatically configure IIS directory settings. |
| 84 | +You can deploy your ASP.NET web application by using the MS-DOS `xcopy` command-line tool. However, it's a good idea to deploy your project instead of using `xcopy`. Similar to the Copy Project command, `xcopy` doesn't register or verify the location of assemblies. Also, for web projects, `xcopy` doesn't automatically configure IIS directory settings. |
85 | 85 |
|
86 | | -For additional information, visit [Deploy an ASP.NET web application by using Xcopy deployment](/troubleshoot/developer/visualstudio/language-compilers/deploy-aspnet-app-xcopy-command). |
| 86 | +For more information, see [Deploy an ASP.NET web application by using Xcopy deployment](/troubleshoot/developer/visualstudio/language-compilers/deploy-aspnet-app-xcopy-command). |
87 | 87 |
|
88 | 88 | ## Set up multiple server ASP.NET web applications and web services |
89 | 89 |
|
90 | | -For most uses of ASP.NET, a single server can handle all requests quickly. However, many environments must deploy multiple servers to handle consistently high volumes of traffic, to support processor-intensive applications, to respond to sudden bursts in traffic, or to meet redundancy requirements. |
| 90 | +For most uses of ASP.NET, a single server can handle all requests quickly. However, many environments require that you deploy multiple servers to handle consistently high traffic volumes, support processor-intensive applications, respond to sudden bursts in traffic, or meet redundancy requirements. |
91 | 91 |
|
92 | 92 | ## Related content |
93 | 93 |
|
|
0 commit comments