HostingEnvironment 類別

參考

定義

命名空間:: System.Web.Hosting

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

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 物件裝載 (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 中支援]

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

適用於

HostingEnvironment 類別

定義

範例

備註

建構函式

屬性

方法

事件

適用於

其他資源