HttpRuntime Class
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Provides a set of ASP.NET run-time services for the current application.
public ref class HttpRuntime sealed
public sealed class HttpRuntime
type HttpRuntime = class
Public NotInheritable Class HttpRuntime
- Inheritance
-
HttpRuntime
The following example demonstrates how to get properties of the HttpRuntime class representing the current application domain and display them to the browser.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Load(Object sender, System.EventArgs e)
{
StringBuilder sb = new StringBuilder();
String nl = "<br />";
sb.Append("AppDomainAppId = " +
HttpRuntime.AppDomainAppId + nl);
sb.Append("AppDomainAppPath = " +
HttpRuntime.AppDomainAppPath + nl);
sb.Append("AppDomainAppVirtualPath = " +
HttpRuntime.AppDomainAppVirtualPath + nl);
sb.Append("AppDomainId = " +
HttpRuntime.AppDomainId + nl);
sb.Append("AspInstallDirectory = " +
HttpRuntime.AspInstallDirectory + nl);
sb.Append("BinDirectory = " +
HttpRuntime.BinDirectory + nl);
sb.Append("ClrInstallDirectory = " +
HttpRuntime.ClrInstallDirectory + nl);
sb.Append("CodegenDir = " +
HttpRuntime.CodegenDir + nl);
sb.Append("IsOnUNCShare = " +
HttpRuntime.IsOnUNCShare.ToString() + nl);
sb.Append("MachineConfigurationDirectory = " +
HttpRuntime.MachineConfigurationDirectory + nl);
label1.Text = sb.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HttpRuntime Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:label id="label1" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
Dim sb As New StringBuilder()
Dim nl As String = "<br />"
sb.Append("AppDomainAppId = " & _
HttpRuntime.AppDomainAppId & nl)
sb.Append("AppDomainAppPath = " & _
HttpRuntime.AppDomainAppPath & nl)
sb.Append("AppDomainAppVirtualPath = " & _
HttpRuntime.AppDomainAppVirtualPath & nl)
sb.Append("AppDomainId = " & _
HttpRuntime.AppDomainId & nl)
sb.Append("AspInstallDirectory = " & _
HttpRuntime.AspInstallDirectory & nl)
sb.Append("BinDirectory = " & _
HttpRuntime.BinDirectory & nl)
sb.Append("ClrInstallDirectory = " & _
HttpRuntime.ClrInstallDirectory & nl)
sb.Append("CodegenDir = " & _
HttpRuntime.CodegenDir & nl)
sb.Append("IsOnUNCShare = " & _
HttpRuntime.IsOnUNCShare.ToString() & nl)
sb.Append("MachineConfigurationDirectory = " & _
HttpRuntime.MachineConfigurationDirectory & nl)
label1.Text = sb.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HttpRuntime Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:label id="label1" runat="server"/>
</form>
</body>
</html>
The HttpRuntime object is used at the beginning of the ASP.NET pipeline model that processes HTTP requests. The ProcessRequest method drives all subsequent ASP.NET Web processing.
Page developers can use the HttpRuntime class properties to find out information about the current application domain for diagnostic purposes, for example. Developers creating custom process pipeline or a custom hosting environment should call the ProcessRequest method from a class derived from the HttpWorkerRequest or SimpleWorkerRequest class.
Http |
Initializes a new instance of the HttpRuntime class. |
App |
Gets the application identification of the application domain where the HttpRuntime exists. |
App |
Gets the physical drive path of the application directory for the application hosted in the current application domain. |
App |
Gets the virtual path of the directory that contains the application hosted in the current application domain. |
App |
Gets the domain identification of the application domain where the HttpRuntime instance exists. |
Asp |
Gets the folder path for the ASP.NET client script files. |
Asp |
Gets the virtual path for the ASP.NET client script files. |
Asp |
Gets the physical path of the directory where the ASP.NET executable files are installed. |
Bin |
Gets the physical path to the /bin directory for the current application. |
Cache |
Gets the Cache for the current application. |
Clr |
Gets the physical path to the directory where the common language runtime executable files are installed. |
Codegen |
Gets the physical path to the directory where ASP.NET stores temporary files (generated sources, compiled assemblies, and so on) for the current application. |
IISVersion |
Gets the version of IIS that is hosting this application. |
Is |
Gets a value that indicates whether the application is mapped to a universal naming convention (UNC) share. |
Machine |
Gets the physical path to the directory where the Machine.config file for the current application is located. |
Target |
Gets the version of the .NET Framework that the current web application targets. |
Using |
Gets a value that indicates whether the current application is running in the integrated-pipeline mode of IIS 7.0. |
Web |
Gets or sets the IServiceProvider instance for dependency injection support. |
Close() |
Shuts down the HttpRuntime instance. |
Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
Get |
Serves as the default hash function. (Inherited from Object) |
Get |
Returns the set of permissions associated with code groups. |
Get |
Gets the Type of the current instance. (Inherited from Object) |
Memberwise |
Creates a shallow copy of the current Object. (Inherited from Object) |
Process |
Drives all ASP.NET Web processing execution. |
To |
Returns a string that represents the current object. (Inherited from Object) |
Unload |
Terminates the current application. The application restarts the next time a request is received for it. |
Product | Versions |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: