HostingEnvironment Třída

Definice

Obor názvů:
System.Web.Hosting
Sestavení:
System.Web.dll

Poskytuje funkce správy aplikací a aplikační služby spravované aplikaci v rámci její domény aplikace. Tato třída se nemůže dědit.

public ref class HostingEnvironment sealed : MarshalByRefObject
public sealed class HostingEnvironment : MarshalByRefObject
type HostingEnvironment = class
    inherit MarshalByRefObject
Public NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject
Dědičnost
Object
MarshalByRefObject
HostingEnvironment

Příklady

Následující příklad kódu je webová stránka, která zobrazuje informace o aplikaci dostupné z objektu 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>

Poznámky

Každá doména spravované aplikace obsahuje statickou instanci HostingEnvironment třídy, která poskytuje přístup k funkcím správy aplikací a aplikačním službám.

Konstruktory

Name Description
HostingEnvironment()

Inicializuje novou instanci HostingEnvironment třídy.

Vlastnosti

Name Description
ApplicationHost

Tato vlastnost podporuje infrastrukturu ASP.NET a není určená k použití přímo z kódu.
ApplicationID

Získá jedinečný identifikátor aplikace.
ApplicationMonitors

Získá skupinu nahraditelných monitorových objektů používaných ASP.NET subsystémy pro zachování stavu aplikace.
ApplicationPhysicalPath

Získá fyzickou cestu na disku do adresáře aplikace.
ApplicationVirtualPath

Získá kořenovou virtuální cestu aplikace.
Cache

Cache Získá instanci pro aktuální aplikaci.
InClientBuildManager

Získá hodnotu, která určuje, zda hostitelské prostředí má přístup k systému sestavení ASP.NET.
InitializationException

Získá všechny výjimky vyvolané během inicializace objektu HostingEnvironment .
IsDevelopmentEnvironment

Získá hodnotu, která označuje, zda aktuální aplikace je ve vývojovém prostředí.
IsHosted

Získá hodnotu určující, zda je aktuální aplikační doména hostována objektem ApplicationManager .
MaxConcurrentRequestsPerCPU

Získá nebo nastaví maximální počet souběžných požadavků na procesor.
MaxConcurrentThreadsPerCPU

Získá nebo nastaví maximální počet souběžných vláken na procesor.
ShutdownReason

Vrátí výčtovou hodnotu, která označuje, proč se aplikace ukončila.
SiteName

Získá název webu.
VirtualPathProvider

Získá zprostředkovatele virtuální cesty pro tuto aplikaci.

Metody

Name Description
CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
DecrementBusyCount()

Sníží počet zaneprázdněných objektů v hostovaném prostředí o jeden.
Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetType()

Získá Type aktuální instance.

(Zděděno od Object)
Impersonate()

Zosobní uživatele reprezentované identitou aplikace.
Impersonate(IntPtr, String)

Zosobní uživatele určeného nastavením konfigurace pro zadanou virtuální cestu nebo zadaný token uživatele.
Impersonate(IntPtr)

Zosobní uživatele reprezentovaného zadaným tokenem uživatele.
IncrementBusyCount()

Zvýší počet zaneprázdněných objektů v hostovaném prostředí o jeden.
InitializeLifetimeService()

Poskytuje objekt HostingEnvironment nekonečné životnosti tím, že brání vytvoření zapůjčení.
InitiateShutdown()

Spustí vypnutí webové aplikace přidružené k tomuto hostiteli a odebere registrované objekty ze systému.
MapPath(String)

Mapuje virtuální cestu k fyzické cestě na serveru.
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu.

(Zděděno od MarshalByRefObject)
MessageReceived()

Tato metoda podporuje infrastrukturu ASP.NET a není určená k použití přímo z kódu.
QueueBackgroundWorkItem(Action<CancellationToken>)

Naplánuje úlohu, která může běžet na pozadí nezávisle na jakémkoli požadavku.
QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Naplánuje úlohu, která může běžet na pozadí nezávisle na jakémkoli požadavku.
RegisterObject(IRegisteredObject)

Umístí objekt do seznamu registrovaných objektů pro aplikaci.
RegisterVirtualPathProvider(VirtualPathProvider)

Zaregistruje novou instanci VirtualPathProvider v systému kompilace ASP.NET.
SetCultures()

Nastaví aktuální vlákno na jazykovou verzi určenou v konfiguračním souboru aplikace.
SetCultures(String)

Nastaví aktuální vlákno na jazykovou verzi zadané virtuální cesty.
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
UnregisterObject(IRegisteredObject)

Odebere objekt ze seznamu registrovaných objektů pro aplikaci.

Událost

Name Description
StopListening

[Podporováno pouze v rozhraní .NET Framework 4.5.1]

Nastane, když pracovní proces nebo fond aplikací přidružený k tomuto hostiteli přestal naslouchat novým požadavkům a nakonec se vypne.

Platí pro