HttpRuntime Class

Definition

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

Examples

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>

Remarks

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.

Constructors

HttpRuntime()

Initializes a new instance of the HttpRuntime class.

Properties

AppDomainAppId

Gets the application identification of the application domain where the HttpRuntime exists.

AppDomainAppPath

Gets the physical drive path of the application directory for the application hosted in the current application domain.

AppDomainAppVirtualPath

Gets the virtual path of the directory that contains the application hosted in the current application domain.

AppDomainId

Gets the domain identification of the application domain where the HttpRuntime instance exists.

AspClientScriptPhysicalPath

Gets the folder path for the ASP.NET client script files.

AspClientScriptVirtualPath

Gets the virtual path for the ASP.NET client script files.

AspInstallDirectory

Gets the physical path of the directory where the ASP.NET executable files are installed.

BinDirectory

Gets the physical path to the /bin directory for the current application.

Cache

Gets the Cache for the current application.

ClrInstallDirectory

Gets the physical path to the directory where the common language runtime executable files are installed.

CodegenDir

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.

IsOnUNCShare

Gets a value that indicates whether the application is mapped to a universal naming convention (UNC) share.

MachineConfigurationDirectory

Gets the physical path to the directory where the Machine.config file for the current application is located.

TargetFramework

Gets the version of the .NET Framework that the current web application targets.

UsingIntegratedPipeline

Gets a value that indicates whether the current application is running in the integrated-pipeline mode of IIS 7.0.

WebObjectActivator

Gets or sets the IServiceProvider instance for dependency injection support.

Methods

Close()

Shuts down the HttpRuntime instance.

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetNamedPermissionSet()

Returns the set of permissions associated with code groups.

GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ProcessRequest(HttpWorkerRequest)

Drives all ASP.NET Web processing execution.

ToString()

Returns a string that represents the current object.

(Inherited from Object)
UnloadAppDomain()

Terminates the current application. The application restarts the next time a request is received for it.

Applies to

See also