Sdílet prostřednictvím


HostingEnvironment Třída

Definice

Poskytuje funkce správy aplikací a aplikační služby spravované aplikaci v rámci domény aplikace. Tuto třídu nelze zdě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
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

HostingEnvironment()

Inicializuje novou instanci HostingEnvironment třídy.

Vlastnosti

ApplicationHost

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

ApplicationID

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

ApplicationMonitors

Získá skupinu nahraditelných monitorovací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á označuje, zda hostitelské prostředí má přístup k ASP.NET sestavení systému.

InitializationException

Získá všechny výjimky vyvolán 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 označující, zda je aktuální doména aplikace 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č aplikace skončila.

SiteName

Získá název webu.

VirtualPathProvider

Získá poskytovatele virtuální cesty pro tuto aplikaci.

Metody

CreateObjRef(Type)

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

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

Snižuje počet zaneprázdněných objektů v hostovaném prostředí o jeden.

Equals(Object)

Určí, zda se zadaný objekt rovná 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 aktuální objekt služby životnosti, který řídí zásady životnosti pro tuto instanci.

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

Type Získá aktuální instanci.

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

Zosobní uživatele reprezentované identitou aplikace.

Impersonate(IntPtr)

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

Impersonate(IntPtr, String)

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

IncrementBusyCount()

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

InitializeLifetimeService()

HostingEnvironment Dává objektu neomezenou životnost tím, že zabrá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)

Mapy virtuální cestu k fyzické cestě na serveru.

MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

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

Vytvoří kopii aktuálního objektu bez MarshalByRefObject podmět.

(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á se může spouštět na pozadí nezávisle na jakémkoli požadavku.

QueueBackgroundWorkItem(Func<CancellationToken,Task>)

Naplánuje úlohu, která se může spouštět 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 VirtualPathProvider instanci v systému kompilace ASP.NET.

SetCultures()

Nastaví aktuální vlákno na jazykovou verzi zadanou 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

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