HostingEnvironment 类

参考

定义

命名空间:: System.Web.Hosting

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

在托管应用程序的应用程序域内向托管应用程序提供应用程序管理功能和应用程序服务。此类不能被继承。

public ref class HostingEnvironment sealed : MarshalByRefObject

public sealed class HostingEnvironment : MarshalByRefObject

type HostingEnvironment = class
    inherit MarshalByRefObject

Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject

继承: Object

MarshalByRefObject
HostingEnvironment

示例

下面的代码示例是显示对象 HostingEnvironment 中可用的应用程序信息的网页。

<%@ Page Language="C#" %>

<%@ Import Namespace="System.Web.Hosting" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  protected void Page_Load(object sender, EventArgs e)
  {
    appID.Text = HostingEnvironment.ApplicationID;
    appPPath.Text = HostingEnvironment.ApplicationPhysicalPath;
    appVPath.Text = HostingEnvironment.ApplicationVirtualPath;
    siteName.Text = HostingEnvironment.SiteName;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>Hosting Environment Sample</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td colspan="2">
            <b>HostingEnvironment Properties</b></td>
        </tr>
        <tr>
          <td>
            Application ID:
          </td>
          <td>
            <asp:Label ID="appID" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Physical Path:
          </td>
          <td>
            <asp:Label ID="appPPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Virtual Path:
          </td>
          <td>
            <asp:Label ID="appVPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Site Name:
          </td>
          <td>
            <asp:Label ID="siteName" runat="server" />
          </td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Hosting" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    appID.Text = HostingEnvironment.ApplicationID
    appPPath.Text = HostingEnvironment.ApplicationPhysicalPath
    appVPath.Text = HostingEnvironment.ApplicationVirtualPath
    siteName.Text = HostingEnvironment.SiteName
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
  <title>Hosting Environment Sample</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td colspan="2">
            <b>HostingEnvironment Properties</b></td>
        </tr>
        <tr>
          <td>
            Application ID:
          </td>
          <td>
            <asp:Label ID="appID" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Physical Path:
          </td>
          <td>
            <asp:Label ID="appPPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Application Virtual Path:
          </td>
          <td>
            <asp:Label ID="appVPath" runat="server" />
          </td>
        </tr>
        <tr>
          <td>
            Site Name:
          </td>
          <td>
            <asp:Label ID="siteName" runat="server" />
          </td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>

注解

每个托管应用程序域都包含类的 HostingEnvironment 静态实例，该实例提供对应用程序管理功能和应用程序服务的访问权限。

构造函数

HostingEnvironment()

初始化 HostingEnvironment 类的新实例。

属性

ApplicationHost	此属性支持 ASP.NET 基础结构，不打算直接从代码使用。
ApplicationID	获取应用程序的唯一标识符。
ApplicationMonitors	获取 ASP.NET 子系统用于维护应用程序运行状况的一组可替换监视器对象。
ApplicationPhysicalPath	获取磁盘上指向应用程序目录的物理路径。
ApplicationVirtualPath	获取应用程序的根虚拟路径。
Cache	获取当前应用程序的 Cache 实例。
InClientBuildManager	获取一个值，该值指示宿主环境是否具有对 ASP.NET 生成系统的访问权。
InitializationException	获取在 HostingEnvironment 对象初始化期间引发的任何异常。
IsDevelopmentEnvironment	获取一个值，该值指示当前应用程序是否处于开发环境。
IsHosted	获取一个值，该值指示当前应用程序域是否在由 ApplicationManager 对象承载。
MaxConcurrentRequestsPerCPU	获取或设置每 CPU 的最大并发请求数。
MaxConcurrentThreadsPerCPU	获取或设置每 CPU 的最大并发线程数。
ShutdownReason	返回指示应用程序终止原因的枚举值。
SiteName	获取站点的名称。
VirtualPathProvider	获取此应用程序的虚拟路径提供程序。

方法

CreateObjRef(Type)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
DecrementBusyCount()	将宿主环境中繁忙对象的计数减一。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetLifetimeService()	已过时。检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
Impersonate()	模拟应用程序标识所表示的用户。
Impersonate(IntPtr)	模拟指定用户标记表示的用户。
Impersonate(IntPtr, String)	模拟由指定虚拟路径的配置设置或由指定用户标记所指定的用户。
IncrementBusyCount()	将宿主环境中繁忙对象的计数加一。
InitializeLifetimeService()	通过阻止创建租约给予 HostingEnvironment 对象无限的生存期。
InitiateShutdown()	开始关闭与此宿主关联的 Web 应用程序，并从系统中移除注册对象。
MapPath(String)	将虚拟路径映射到服务器上的物理路径。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
MessageReceived()	此方法支持 ASP.NET 基础结构，不打算直接从代码使用。
QueueBackgroundWorkItem(Action<CancellationToken>)	计划可以在后台运行（与任何请求无关）的任务。
QueueBackgroundWorkItem(Func<CancellationToken,Task>)	计划可以在后台运行（与任何请求无关）的任务。
RegisterObject(IRegisteredObject)	将一个对象放在应用程序的已注册对象列表中。
RegisterVirtualPathProvider(VirtualPathProvider)	在 ASP.NET 编译系统中注册新的 VirtualPathProvider 实例。
SetCultures()	将当前线程的区域性设置为应用程序配置文件中指定的区域性。
SetCultures(String)	将当前线程的区域性设置为指定虚拟路径的区域性。
ToString()	返回表示当前对象的字符串。 (继承自 Object)
UnregisterObject(IRegisteredObject)	从应用程序的已注册对象列表中移除一个对象。

事件

StopListening

[仅在 .NET Framework 4.5.1 中受支持]

当辅助进程或与该主机相关联的应用程序池已停止侦听新的请求，并将最终关闭时才发生。

适用于

HostingEnvironment 类

定义

示例

注解

构造函数

属性

方法

事件

适用于

其他资源