HttpRuntime Class

Reference

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

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: Object
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

Jaa