共用方式為


HostingEnvironment 類別

定義

在 Managed 應用程式的應用程式定義域中向其提供應用程式管理功能和應用程式服務。 此類別無法獲得繼承。

public ref class HostingEnvironment sealed : MarshalByRefObject
public sealed class HostingEnvironment : MarshalByRefObject
type HostingEnvironment = class
    inherit MarshalByRefObject
Public NotInheritable Class HostingEnvironment
Inherits 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 物件裝載 (Host)。

MaxConcurrentRequestsPerCPU

取得或設定每一個 CPU 的最大並行要求數目。

MaxConcurrentThreadsPerCPU

取得或設定每一個 CPU 的最大並行執行緒數目。

ShutdownReason

傳回列舉值,表示應用程式結束的原因。

SiteName

取得此站台的名稱。

VirtualPathProvider

取得這個應用程式的虛擬路徑提供者。

方法

CreateObjRef(Type)

建立包含所有相關資訊的物件,這些資訊是產生用來與遠端物件通訊的所需 Proxy。

(繼承來源 MarshalByRefObject)
DecrementBusyCount()

將裝載環境中的忙碌物件計數減少一個。

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetLifetimeService()
已過時。

擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。

(繼承來源 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 中支援]

發生於與此主機相關聯的背景工作處理序或應用程式集區,已停止接聽新要求且最終將關閉時。

適用於