HostingEnvironment Třída
Definice
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 : MarshalByRefObjectpublic sealed class HostingEnvironment : MarshalByRefObjecttype HostingEnvironment = class
inherit MarshalByRefObjectPublic NotInheritable Class HostingEnvironment
Inherits MarshalByRefObject- Dědičnost
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. |