HostingEnvironment Třída

Reference

Definice

Obor názvů:: System.Web.Hosting

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: 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

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